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Notices 


Any reference to an IBM licensed program in this licensed document does not imply 
that IBM intends to make it available in all countries in which IBM operates. Any 
reference to an IBM product, program, or service is not intended to state or imply 
that only that IBM product, program, or service may be used. Any functionally 
equivalent product, program, or service that does not infringe any of the intellectual 
property rights of IBM may be used instead of the IBM product, program, or 
service. The evaluation and verification of operation in conjunction with other pro- 
ducts, except those expressly designated by IBM, are the responsibility of the user. 


IBM may have patents or pending patent applications covering subject matter 
described in this document. The furnishing of this document does not give you any 
license to these patents. You can send license inquiries, in writing, to: 


IBM Director of Licensing 

International Business Machines Corporation 
500 Columbus Avenue 

Thornwood, New York 10594 

United States of America 


The licensed programs described in this document and all licensed material avail- 
able for them are provided by IBM under terms of the IBM Customer Agreement. 


This document is not intended for production use and is furnished as is without any 
warranty of any kind, and all warranties are hereby disclaimed including the warran- 
ties of merchantability and fitness for a particular purpose. 


Programming Interface Information 


This book is intended to help the customer customize Advanced Communications 
Function for Network Control Program (NCP) and System Support Programs (SSP). 
This book primarily documents Product-Sensitive Programming Interface and Asso- 
ciated Guidance Information provided by NCP. 


Product-Sensitive programming interfaces allow the customer installation to perform 
tasks such as diagnosing, modifying, monitoring, repairing, tailoring, or tuning of 
this IBM software product. Use of such interfaces creates dependencies on the 
detailed design or implementation of the IBM software product. Product-Sensitive 
programming interfaces should be used only for these specialized purposes. 
Because of their dependencies on detailed design and implementation, it is to be 
expected that programs written to such interfaces may need to be changed in order 
to run with new product releases or versions, or as a result of service. 


However, this book also documents General-Use Programming Interface and Asso- 
ciated Guidance Information. 


General-Use programming interfaces allow the customer to write programs that 
obtain the services of SSP. 
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General-Use Programming Interface and Associated Guidance Information is identi- 
fied where it occurs, either by an introductory statement to a chapter or section or 
by the following marking: 


| | General-Use Programming Interface | 
General-Use Programming Interface and Associated Guidance Information... 


aaa End of General-Use Programming Interface _ 


Trademarks 


The following terms, denoted by an asterisk (*) at their first occurrence in this publi- 
cation, are trademarks of the IBM Corporation in the United States or other coun- 
tries or both: 


BookManager | MVS/XA VTAM 
IBM NetView VSE/ESA 
Library Reader Systen/370 

MVS/ESA VM/ESA 
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About This Book 


This book provides information to help you customize Advanced Communications 
Function for Network Control Program (NCP) and System Support Programs (SSP). 


Customizing NCP means modifying it to enhance support for certain stations or to 
provide support for stations that are not currently supported by the IBM-supplied 
programs. Customization can also include writing programmed Systems Network 
Architecture (SNA) resources that reside in the communication controller. 


Customizing SSP means modifying it to control the generation process for both 
NCP and Emulation Program (EP). You can create generation applications that 
process the NCP or EP generation definition as part of the SSP generation 
process. This enables you to define network resources not provided by the 
IBM-supplied definition functions. 


NCP and SSP Customization Reference is intended to supplement NCP and SSP 
Customization Guide and provides a quick reference to IBM-supplied NCP 
customization macros and NDF internal utilities for user-written generation applica- 
tions. 


Who Should Use This Book 


This book is for programmers who want to modify or enhance an NCP or the gen- 
eration process for NCP and EP. You must have a detailed knowledge of the func- 
tion and operation of NCP. You must also be familiar with the basic concepts of 
data communication and SNA. 


How to Use This Book 


Before you begin to customize an NCP you should read NCP and SSP 
Customization Guide to learn how to use the NCP customization macros and how 
to write and use applications. You may need to refer to /BM 3704/3705 Assembler 
Language, which describes the assembler language used with all IBM communi- 
cation controllers. You may also need to refer to Principles of Operation for your 
controller. 


Read Part 1 to learn about the NCP customization macros and the attachments for 
user-written line control code in NCP code. This part contains supervisor call 
(SVC) codes and functional groupings of macros, an alphabetical listing of the NCP 
macros, and a description of entrances and exits for user-written line control. 


Read Part 2 to learn about the NCP/EP definition facility (NDF) internal utilities you 
can use in your generation applications. You can use these utilities to manipulate 
strings, pass link-editing statements, and create error messages. These utilities are 
listed in alphabetical order. | 
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| Terms Used in This Book 


| The following descriptions explain how terms are used in the NCP, SSP, and EP 
| library. 


| “MVS,” “VM,” and “VSE” 

I The term MVS means the MVS/XA* and MVS/ESA* systems. The term VM means 
| the VM/ESA* systems in the CMS environment. The term VSE means the 

| VSE/SP, VSE/ESA*, and VSE/Advanced Function operating systems. If information 
| is applicable to only one system, the specific system name is used. 


“Port” and “Channel” with LPDA 

In discussions concerning link problem determination aid (LPDA) for multiport and 
data-multiplex mode (DMPX) modems, the terms port and channel are synony- 
mous. Although port is the more commonly used term, channe/ can be used in 
sections describing LPDA. 


ee eee 


“IBM Special Products or User-Written Code” 

This book sometimes refers to [BM special products or user-written code. This 
phrase means IBM” special products such as Network Terminal Option (NTO), 
Network Routing Facility (NRF), and X.25 NCP Packet Switching Interface (NPSI), 
or user-written code. 


| IBM 3745 Communication Controller Model Numbers 
| In this book, the term /BM 3745 Communication Controller refers to all IBM 3745 
| models. When particular models are discussed, the appropriate model numbers 
| are specified. Model numbers include IBM 3745-130, 3745-150, 3745-160, 

| 3745-170, 3745-17A, 3745-210, 3745-21A, 3745-310, 3745-31A, 3745-410, 

| 3745-41A, 3745-610, and 3745-61A. 


| “NCP V7R2” 

| In this book, unless otherwise specified, the term NCP V7A2 refers to NCP Version 
| 7 Release 2 with or without the optional NCP feature for 3746 Model 900 

| connectivity subsystem support. To use this feature, you must have the 3746 

| Model 900 installed in your controller. 


How Numbers Are Written 


This book shows numbers over 9999 in metric style, which means that a space is 
used instead of a comma to separate groups of three digits. For example, the 
number ten thousand five hundred fifty-two is written 10 552. However, keyword 
values, for example, SALIMIT=65535, do not use a blank. 


What Is New in This Book 


| This edition contains no new editorial or technical changes. 
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Where to Find More Information 


A good place to start any task regarding NCP, SSP, or EP is NCP V7R2, SSP 
V4R2, and EP R12 Library Directory. This directory introduces the enhancements 
for the current release and shows where these enhancements are described in the 
NCP library. It gives you an overview of NCP, SSP, and EP and directs you to 
information on a variety of tasks related to these programs. When you are using 
the book online, you can use hypertext links! to move directly from task and 
enhancement descriptions to the appropriate chapters of other books in the library. 


Information for NCP Tasks 
The books in the NCP, SSP, and EP library are listed below according to task, 
along with closely related books and tools you may find helpful. See “Bibliography” 
on page 547 for a brief summary of each book in the NCP, SSP, and EP library 
and listings of related publications. 


Table 1 (Page 1 of 2). Sources of Information by Task 


Order No. Title Hardcopy Softcopy 

Planning 

$C31-7122 Planning for NetView, NCP, and VTAM 8 g 

$C31-7123 Planning for Integrated Networks 5 

SX75-0092 Planning Aids: Pre-installation Planning 5 
Checklist for NetView, NCP, and VTAM 

$C31-6259 NCP V7R2, SSP V4R2, and EP R12 7 a 
Library Directory 

Installation and Resource Definition 

$C31-6221 NCP, SSP, and EP Generation and a a 
Loading Guide 

SC31-6258 NCP V7A2 Migration Guide a a 

$C31-6223 NCP, SSP, and EP Resource Definition a a 
Guide 

SC31-6224 NCP, SSP, and EP Resource Definition a Z 
Reference 


Customization 


LY 43-0031 NCP and SSP Customization Guide a 

LY 43-0032 NCP and SSP Customization Reference # 

Operation 

$C31-6222 NCP, SSP, and EP Messages and 7 & 
Codes 

N/A Online Message Facility D 


D Available on diskette for the IBM OS/2 environment. 


1 A hypertext link is a pointer from a location in an online book to another location in the same book or another book. By selecting 
highlighted information, such as a message number, you can move quickly to related information and, if desired, back again. 
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Table 1 (Page 2 of 2). Sources of Information by Task 
Order No. Title 


Diagnosis 

LY 43-0033 NCP, SSP, and EP Diagnosis Guide 

LY 43-0037 NCP, SSP, and EP Trace Analysis 
Handbook 

LY 43-0029 NCP and EP Reference 

LY 43-0030 NCP and EP Reference Summary and 
Data Areas 

LK2T-1999 NCP, SSP, and EP Diagnosis Aid 

Monitoring and Tuning 

SC31-6247 NTune User's Guide 

LY 43-0035 NTuneNCP Reference 


D Available on diskette for the IBM OS/2 environment. 


Hardcopy Softcopy 


Those publications available as softcopy books have cross-document search and 
hypertext links for speedy, online information retrieval. These softcopy books are 
grouped together on an electronic bookshelf and are part of the /BM Networking 
Systems Softcopy Collection Kit on compact disc read-only memory (CD-ROM). 


You can view and search softcopy books by using BookManager* READ products 
or by using the IBM Library Reader® product included on CD-ROM. For more infor- 
mation on CD-ROMs and softcopy books, see /BM Online Libraries: Softcopy Col- 
lection Kit User's Guide and BookManager READ documentation. 
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Chapter 1. NCP Macro Overview 


This chapter lists supervisor call (SVC) codes for Network Control Program (NCP) 
and groups these macros by function. 


Before you begin to customize NCP you should read NCP and SSP Customization 
Guide to learn how to write customized NCP routines and use the NCP 
customization macros. You may need to refer to 3704/3705 Communications Con- 
troller Assembler Language, which describes the assembler language used with all 
IBM communication controllers. Controller assembler is a modified version of 
System/370* Assembler. You may also need to refer to Principles of Operation for 
your controller. 


Note: The following macros might be in the IBM-supplied NCP code, but are not 
supported for use in the NCP customization process: 


EXECBHR SAPTR SUPVNUC@ 
GPTINV SEQJMP XlIO CHANANS 
POST SETXIT XlIO CHANNEL 


SVC Codes for NCP Macros 


An SVC code is generated whenever level 5 uses a supervisor macro. Table 2 
shows these codes and their associated macros. 


Table 2 (Page 1 of 2). SVC Codes for Supervisor Macros 


Code Macro Code Macro 

SVC01 LEASE SVC36 ABORT,CC#0,SYSOPT 
SVC02 RELEASE SVC37 RSLVNAD 

SVC03 CHAIN SVC38 XIO SDLC Link 

SVC04 UNCHAIN SVC39 XPORTVR 

SVC05 SCAN SVC40 COPYPIU (LEASE=NO) 
SVC06 POINT SVC41 (Reserved) 

SVC07 DEQUE SVC42 COPYPIU (LEASE=YES) 
SVCO08 ENQUE SVC43 RSLVSSCP 

SVCO09 ADVAN SVC44 XIO (CHANANS) 
SVC10 INSERT SVC45 XIO (Channel,CAB=) 
SVC11 EXTRACT SVC47 NCHNG 

SVC12 RETURN SVC48 COMMIT 

SVC13 CHAP SVC49 DECOMMIT 

SVC14 TRIGGER SVC60 PEPSWH 

SVC15 QPOST SVC61 BFREVENT 

SVC16 CALL SVC62 ABORTVR 

SVC17 X!IO (BSC/SS line) SVC64 PRELEASE 

SVC18 XIO (channel) SVC65 (Reserved) 

SVC19 RSLVSNP SVC66 SVC66 ATTACHVR 

SVC20 XIO (set mode) SVC67 DETACHVR 

SVC21 XIO (immediate) SVC68 RSLVNET 

SVC22 SETIME SVC70 ALLOCATE 

SVC23 TPPOST SVC72 ACTVRIT 

SVC24 RSLVRID SVC73 DACTVRIT 

SVS25 COPYBCU SVC74 LINKTGB 

SVC26 SYSXIT SVC75 RSLVTGB 

SVC27 FLIPPS SVC76 SETTGB 
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Table 2 (Page 2 of 2). SVC Codes for Supervisor Macros 


Code 


SVC28 
SVC29 
SVC30 
SVC31 
SVC32 
SVC33 
SVC34 
SVC35 


Macro 


(Reserved) 


ABORT,CC=0 


ABORT,CC#0,RELEASE 
ABORT,CCz0,PASS 


Code 


Macro 


XIO(TG) 
ROUTE 
TRACEPIU 
NVRID 
VRACT 
UACTRTN 
URETURN 
FETRACE 


The SVC code is contained in the linkage between levels 5 and 4. The linkage, 
generated by the RNSVC macro, consists of an EXIT instruction, SVC code, flags, 
communication bits, parameters, and space for output variables. Table 3 shows 
the linkage generated by RNSVC. 


a 
> 
@ 
Gd 
fy 
‘S 
°c 
a 
fe) 
“hth 
> 
0) 
We 
> 
ph) 
© 
@ 
) 
+) 
a 
© 
© 
4) 
Q. 
ey 
< 
my) 
= 
< 
gq) 


Generated 


Instructions 


EXIT 


DC AL1 () 


DC AL1 () 


DC AL4() 
DC AL4 () 
LA VAR,O 


code 


opvars 


NO 


Definition 
Value 
EXIT instruction. 
SVC code 
One-parm flag 
Three-parms flag 
Communication bit 
Parameter 1 code 
Parameter 2 code 
Unused (alignment only) 
Pseudo parm 3 flag 
Communication bit 
Parameter 3 code 
Communication bits 
Inline parameter 3 


Output variables 


Bytes 2 and 3 are always generated. If the one-parm flag (byte 2, bit 7) is on, byte 
3 contains one input parameter indicated in bits 2 to 4. Therefore, bits 0, 1, 5, 6, 
and 7 in byte 3 are available for use as communication bits. In this case, only 


bytes 2 and 3 are generated. 


If the one-parm flag is off, only bit 1 of byte 3 is available for use as a communi- 
cation bit. Bits 2 to 7 are used as input parameters. In this case, if more than one 
communication bit is required, the three-parms flag (byte 3, bit 0) is on, bytes 4 and 
5 are generated, and all communication bits are in byte 5. If the pseudo parm 3 
flag is on (byte 5, bit 0), that byte does not contain a parameter 3 code and exists 
solely for the communication bits. Inline parameters are 4-byte address constants 
generated if parameters are in label notation rather than register notation. 
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The values for parameter 1 codes (byte 3, bits 2 to 4) are as follows. 


Code Value Location of Input Parameter 
Register 2 

Register 3 

Register 4 

Register 5 

Register 6 

Register 7 

Inline parameter 

Active queue control block (QCB) 


NO OR @D DM — O 


The values for parameter 2 and 3 codes (byte 3, bits 5 to 7 or byte 5, bits 2 to 4) 
are the same as the parameter 1 codes, except that bit 7 is unused. 


When the EXIT instruction is executed, level 4 receives control and sets up the 
level 4 linkage registers as follows. 


Register Content 

0 Address register 

1(0) Level 5 register 1, byte 0 

1(1) Communication bits (byte 3 or 5) 

2 Parameter 1 

3 Parameter 2 

4 Parameter 3 

5 Service routine work register 

6 Level 4 save area 

7 Level 5 instruction address register (updated past communi- 


cation bits) 


The SVC code is used as an index into the branch table of supervisor nucleus rou- 
tines to pass control to the appropriate routine. 


NCP Macros Grouped by Function 


This section groups the NCP macros by function. The groups are in alphabetical 
order. Each macro appears in the functional group in which it is most commonly 
used; however, many macros can be used in other groups as well. 


Binary Tree Macros: Allow you to work with binary trees, mostly used in routing 
functions. 


BICHECK BTINSERT BISEARCH 
BIDELETE 


Block Handler Macros: Provide access to the block handling routines (BHRs). 
The block handling routines are supplied by NCP or are user-written. Block han- 
dling routines provide message processing functions within the communication con- 


troller. 

ABORT GETPARM GRPEND 
BHEXIT GETPT GRPENTRY 
BLKENTRY 
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BSC and Start-Stop Support Macros: Are used exclusively for binary synchro- 
nous communications (BSC) and start-stop line control routines: 


BLDR INCRP SETRP1C 
COPYBCU PUTBYTE TPPOST 
GETBYTE 


Buffer Management Macros: Reserve buffers from and return buffers to the 
buffer pool. Buffers are the working storage of NCP. You can also use these 
macros to get information contained in the buffers, or to chain the buffers together 
and manipulate buffer chains. 


CHAIN PRELEASE TAGBUFF 
CHECKSSI RELEASE UNCHAIN 
LEASE SCAN 


Channel Macro: Communicates across the channel from NCP to the host 
processor. To use this macro, you must have detailed knowledge of the channel 
adapters and NCP configuration. 


CAIO 


Flow Control Macros: Control the pacing and flow of path information units 
(PIUs) along virtual routes. 


ALLOCATE DECOMMIT VRIMTASK 
COMMIT VREVENT 


Interrupt Macros: \|NHIBIT and RESET are used in program levels 2 to 4 to 
enable or disable certain interrupts. The interrupts are enabled or disabled by 
placing a mask in a specified register. Use PCIL4 in program levels 1 to 4 to 
request level 4 to carry out certain types of program control interrupts. 


INHIBIT PCIL4 RESET 


Level 5 Input/Output Macros: May be used by program level 5 routines to send 
request and response PIUs from the current NCP resource (origin) to any other 
resource in the network (destination). These macros are also used by program 
level 5 to request I/O code to carry out specific functions. To use these macros, 
you must have a knowledge of the network addresses, virtual routes, and the 
queue control block (QCB) associated with the task that you want to perform. 


NEOENQ XIO IMMED XIO LINK 

NEOXPORT X!1O LINE XIO SETMODE 

NPAPIU 

Linked List Management Macros: Manage a form of linked list called an 
ACHAIN. 

ACHAIN ASCAN AUNCHAIN 

AFIND 
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Miscellaneous Macros: \mprove the quality and productivity of programming by 
replacing frequently used coding sequences with macros. 


Branch macros: 


BAL BNC BNZ 
BCR BNDH BP 
BH BNE BPZ 
BM BNH BZR 
BMZ BNL 


Other miscellaneous macros: 


COMPARE LA SWAP 
DEFMSK SETXTRN 


NCP Information Macros: Obtain information about the network and the subarea 
containing this NCP. These macros also provide information about NCP itself and 
the resources defined to NCP. 


BUFCHK PACEMAP RSLVRID 
DEVPARMS RCBSCAN RSLVSNP 
GETCB ROUTEMAP RSLVSSCP 
GETIME RSLVCAP RSLVTGB 
NPAQINFO RSLVDYN RSLVVVTI 
NPAQSTAT RSLVNAD UPARMS 
NPARMS RSLVNET VRACTCK 


PIU Management Macros: Copy, alter, or get information from a PIU. 


BUILDPIU ECBINIT MOVECHAR 
COPYPIU EXCR PIUEND 
ECB MOVE 


Problem Determination Macros: Aid in problem determination for NCP. 


ABEND GALERT SAVESQ 
DTRACE MAINT TRACEPIU 
FETRACE MAINTCS 


Queue Management Macros: Add elements to any place on the queue, move 
elements from one queue to another, set the priority of elements within a queue, 
check validity on the queue control block (QCB), and purge the QCB. 


ADVAN INSERT PURGQCB 
DEQUE MVQUE SETPRI 
ENQUE POINT VALQCB 
EXTRACT 


Save Area Management Macros: Create and use save areas. Save areas retain 
register contents during program execution. 


CXTSVX RESTORE SAVEAREA 
LDM SAVE STRM 
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Scanner Macros: Communicate across the scanners in the communication con- 
troller from NCP to a terminal or other link-attached station. These macros also 
start input and output operations from background code. You must know how 
scanners operate and you must understand NCP configuration to use these 
macros. 


SETLATO IOHM OUTICW1 


Shift Macros: Shift the bit positions of a specified register to the left or right. 


ASHIFT SLLH SRLB 
SLL SRL SRLH 
SLLB 


Structuring Macros: Enable structured programming in IBM controller assembler 
language. These are the most frequently used macros in NCP programming. The 
functions available with these macros are similar to those of other high-level lan- 


guages. 

ANDIF DOUNTIL ENDIF 
CASE DOWHILE IF 
CASEIF ELSE LEAVEDO 
CASENTRY ENDCASE _ORIF 
CASEXIT ENDDO THEN 


Subroutine Macros: Transfer control within NCP from one routine to another. 


CALL PERFORM ROUTINE 
LINK RETURN SUBRTN 


Supervisor Macros: Are used by NCP supervisor services to establish linkage 
between the background routines and the supervisor service routines. 


RNSVC SVLINK 


Task Control Macros: Control task execution within NCP regarding priorities and 
other task states. 


BFREVENT QPOST SYSXIT 
CHAP SETEVNTL TRIGGER 


Timer Macros: Set, refresh, or refer to NCP timer values. If you are creating your 
own line-control routines, you must also create your own timer routines. These are 
the macros that create those routines. 


SETIME TVSNEW TVSRTRN 
TVSIDL TVSRAS TVSTIME 
TVSMOD TVSREF 


Transmission Group Macros: Control transmission group protocol. These 
macros activate or deactivate a transmission group. They also control data flow 
and check the specific states and conditions of a transmission group. 


LINKTGB TESTTGB XIOFL 
ROUTE XlO TG XPC 
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User Line Control and Programmed Resource Macros: Allow you to carry out 
your own line control in place of the line control supplied by IBM within NCP. 


FINDUACB NCHNG SDB 
FVTABLE NEOAXT UACTRIN 
LASTUACB POSTUACB URETURN 


Virtual Route Macros: Control virtual route protocols. They also attach and 
detach NCP resources from internal NCP virtual routes. They function the same 
way in networks that are attached to NCP through the SNA network interconnection 


process. 
ABORTVR CONVRT PIUDEALL 
ACTVRIT DACTVRIT VRACT 
ATTACHVR DETACHVR XPORTVR 
CHECKVR NVRID 
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Chapter 2. Macro Directory 


This chapter describes all of the NCP macros available for customizing NCP. For 
easy reference, these macros are arranged alphabetically. 


Keyword Syntax Diagrams 
This book uses standard IBM syntax diagrams to describe the syntax of the NCP 
macros. These diagrams use the following conventions: 


e Read the diagrams from left to right. In general, any path between the start 
symbol (>>) and the end symbol (®<) represents valid coding for a keyword. 


pe—| Syntax diagram /_-@-—_——_—___________________________»« 


e A long diagram may be broken into two or more lines. 


wy rice ia 
»—| Second line, RK _—_____—___ > 


e A keyword that appears on the main path is required. You must code all 
required keywords. 


>>—KE YWORD=value—@———J_ He eeoe_4e_§ioeoaee_ce§e >» 


e A keyword that appears below the main path is optional. You do not need to 
code optional keywords. Most NCP keywords are optional. 


L_KEYWORD-value— 


e When you can choose from more than one keyword value, those values are 
stacked vertically below the main path. 


L-KeYWoRD-—-VALUEI——| 
VALUE2 


e If a keyword has a default value, the keyword and value appear above the 
main path. 


KEYWORD=VALUE1 
aa a 
~Lvatu E2 


e Uppercase characters show values you code exactly as shown (VALUE1 
below). Uppercase characters in a mixed-case string indicate that you can 
code an abbreviation (VALue2 below means you can code VAL or VALUE2). 
Lowercase italics show variables for which you need to supply a value, such as 
a number or string (va/ue3 below). Do not code a space or comma between 
the digits of a numeric value. 
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KEYWORD=——VALUE]1 
VALue2 
value3 


e Multiple keyword values in parentheses are called suboperands. Required sub- 


operands appear on the main path between the parentheses (va/ue7 below). 
Optional suboperands appear below the main path between the parentheses 
(value2 below). Default values for optional suboperands appear above the 
main path between the parentheses (VALUE2A below). All suboperands must 
be separated by commas. 


| »VALUE2A | 
KEYWORD= (value?) 


7 »value2 


Note: If a default is not shown for an optional suboperand, this means that 
either there is no default or that the default depends on what you code 
on other keywords or suboperands. You have to read the keyword 
description to find out about this. 


An arrow returning to the left above a suboperand indicates that you can code 
multiple values, enclosed in parentheses and separated by commas. 


p> —KEYWORD=(—¥-value—-) 


An arrow returning to the left above a stacked list of suboperands means that 
you can code as many of the suboperands as you need and in any order. Do 
not code the same suboperand more than once. Separate each suboperand 
you code with a comma. For example you could code 
KEYWORD=(VALUE3,VALUE1) for the keyword below. 


fsaaaied “VALUE1 J 
VALUE2 
VALUE3 


If you omit an optional suboperand, code a comma to indicate its position. For 
example you could code KEYWORD=(VALUE1B,,VALUES3B) for the keyword 
below to omit the second suboperand. Commas are not required if you omit 
optional suboperands at the end of a suboperand list. For example you could 
code KEYWORD=(VALUE1B,VALUE2A) or KEYWORD=(VALUE1B,VALUE2A,) 
to omit the last suboperand for the keyword below; the result would be the 
same. If you code only the first suboperand, parentheses are not required. 

For example you could code KEYWORD=VALUE1B or KEYWORD=(VALUE1B) 
for the keyword below; the result would be the same. If you omit all suboper- 
ands or do not code the keyword, the defaults are used. For example you 
could code KEYWORD=(), KEYWORD=(,,), or not code the keyword at all for 
the keyword below; the result would be the same. 


VALUE1A VALUE2A VALUE3A 
KEYWORD=( , ’ ) 

VALUE1A VALUE2A VALUE3A 

VALUE1B VALUE2B VALUE3B 
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e Restrictions on the use of a keyword value are indicated by superscript 
numbers in parentheses and are explained below the diagram. Do not code 


the superscript number or parentheses. 


LxeywoRD=—--VALUEI——— 
VALUE2 


1 Restriction on VALUE2. 


e A section of a long diagram may appear separately below the main diagram. 


KEYWORD=(—{ Suboperands |) 
Suboperands: 


VALUEJA VALUE3A 
,—-VALUE2A va tue3}———__. —._, 
VALUE1A [-VALUE2B ,value4 
VALUE1B 


VALUE2C 


Description Conventions 


The following conventions are used to describe certain keyword values: 


e An ellipsis (...) shows that you can code a sequence of values within paren- 


theses. 


e Quotation marks must be used to frame a character string if it can be confused 
with a keyword value for a keyword. Using quotation marks allows you to use 


certain names as symbols. 


e Within syntax diagrams, keywords that are always required appear first, fol- 
lowed by keywords that are conditional or optional. 


e Data set (file) names must begin with an alphabetical character or $, @, or #. 


Some of the format descriptions of the macros make a distinction between absolute 
and label (or equatea) notation. When a format description does not include either 
of these terms, both forms are valid. These two terms are defined as follows: 


Absolute A notation expressed in terms which can be immediately evaluated. 


Label A notation expressed as a label which is resolved as the value defined 
by an assembler statement label. The label is also Known as an 
equated notation and may refer to a constant, a memory address, or a 


register. 


Table 4 shows examples of notations expressed in absolute terms and as labels. 


Table 4 (Page 1 of 2). Absolute and Labe! Terminology in Format Description Notations 


Notation Example 
Absolute decimal LEASE COUNT=1,... 
Absolute hexadecimal LEASE COUNT=X'1',... 
Absolute register! LEASE ECB=2,... 
Absolute byte register! | LEASE  COUNT=1(1),... 
Label decimal | ONE EQU 1 

LEASE COUNT=ONE,... 
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Table 4 (Page 2 of 2). Absolute and Label Terminology in Format Description Notations 


Notation Example 
Label hexadecimal ONEH EQU. X'1' 
LEASE COUNT=ONEH,... 
Label register! REG2 EQUR 2 
LEASE ECB=REG2,... 
Label byte register! REGILO EQUR 1(0) 


LEASE COUNT=REGILO,... 
1 _ Unless otherwise indicated, do not specify register 0. 


Coding the SUPV Keyword 


Macro Names 


In some cases, the keyword format of a supervisor macro depends on the coding of 
the SUPV keyword. Where these differences occur, formats are supplied for the 
variation of the macro. 


Note: If you are adding user routines to NCP, exercise caution in the use of 
SUPV. Incorrect usage will cause the system to abend. 


Code SUPV=NO (or omit the keyword) when level 5 code uses task, queue, or 
buffer management macros. These macros generate an EXIT instruction followed 
by a DC instruction initialized with an SVC code. When the EXIT instruction is 
used in level 5, the level 5 instruction address register is updated to point to the 
SVC code. The EXIT from level 5 causes a level 4 interrupt. 


Code SUPV=YES when routines at levels 1, 2, 3, and 4 use task, queue, or buffer 
management macros. The following macros generate inline code when 
SUPV=YES. (LEASE generates inline code when SUPV=CHARSERV.) 


ACHAIN - CONVAT SCAN 
ADVAN DEVPARMS SETEVNTL 
AFIND ECBINIT SETXTRN 
ASCAN LEASE TAGBUFF 
AUNCHAIN MOVE UNCHAIN 
CHAIN POINT VRIMTASK 
CHECKSS| RCBSCAN XIOFL 
CHECKVR RSLVVVTI ~ VALQCB 


The remaining macros with SUPV=YES generate a branch to the service routine 
that does the requested function. The service routine, which executes at the same 
level as the branch instruction, saves and restores all registers that it uses. 


You can assign a name to most macro definitions to label the macro. You are 
required to assign a name to some macros. The macro name is shown as the 
name parameter in the illustration of each macro for which it is valid. Unless other- 
wise indicated, the description of the macro name is as follows. 
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Parameters 
See 


Function Provides a label to be inserted on the first statement of the generated 
source. 


Format Up to 8 characters. The first character can be A to Z, $, #, or @. The 
remaining characters can be A to Z, 0 to 9, $, #, or @. 


Default None. 
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The ABEND macro abnormally terminates NCP execution and posts a specified 
abend code at storage location XDH + '60'. 


Parameters 


a $$ 


Function Specifies the abend code to be posted by the supervisor, indicating the 
cause for stopping NCP execution. 


Format Absolute or register notation. 
Default 0. 


Remarks The macro always loads the abend code into register 1. Register 0 is 
not allowed. 


-,SUPY=7-NO- = 
YES 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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ABORT—Stop the Execution of a Block Handler 


The ABORT macro is used by block handling routines (BHRs) to prematurely stop 
the execution of the current block handler (BH). The completion code determines 
how the block is to be processed. 


Register 0 is not allowed for register parameters. 


Syntax 


ea ee (bcu_address ) ,—response——-—W_________—- 
name 


» DATADSP=SYSOPT 


» DATADS P= 


P aimee ts 
,CC=completton_code 


Parameters 


»>—(bcu_address) ,—_—____$____—_ > 


Function Specifies the register containing the address of the block control unit 
(BCU) that is being aborted. 


Format __ Register notation. 
Default None. 


Remarks Register 1 is not allowed. Be sure that the BCU that Is specified does 
not reside on a queue. 


PR TESDONS Cy ee a eS ee 


Function Specifies the bit configuration to be stored in the system response byte 
of the basic transmission unit (BTU). 


Format Byte register notation or an absolute value from 0 to 255. 
Default None. 


Remarks Register 1(0) is standard. 
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» DATADSP=SYSOPT | 
» DATADS P=——RELEASE 
Pas 
SYSOPT 


Function 


Format 
Default 
Remarks 


Specifies what happens to the buffers used for the BTU to be sent to 
the host. 


RELEASE, PASS, or SYSOPT. 
SYSOPT. 


Specify RELEASE if the buffer chain associated with the BTU Is to be 
released. Specify PASS if the buffer chain is not to be released. 


Specify SYSOPT when the general communication byte (SYSFLGO) is 
to be examined to determine whether to release data. 


,CC=0 
E CC=comp ee 


Function 


Format 
Default 


Remarks 


Specifies the completion code, which determines the type of abort being 
performed. 


Absolute value of 0 to 255. 
0. 


A completion code of 0 indicates that only the current block handler exe- 
cution is to be aborted and normal block processing is to continue. All 
other keywords are ignored. 


A completion code other than 0 indicates that the BTU is to be sent to 
the host by a TPPOST macro. The BCU has been removed from the 
queue. 
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ABORTVR—Cancel a Virtual Route Activation Attempt 


Syntax 


The ABORTVR macro cancels an ongoing NCP virtual route activation attempt for 
a resource if that process was started by the VRACT macro. The input is the 
pointer to the resource connection block (RCB) of the resource undergoing acti- 
vation. When ABORTVR is issued, the RCB could be in one of three states: 


e If the RCB is on the ACTVR queue, it is removed from the queue. 


e If the RCB is already attached to a VRB that is waiting for an ER.ACT reply or 
ACTVR response, the RCB is taken off the VRB. 


e lf the RCB is attached to an active VRB, the RCB is detached. In this case, 
the resource is triggered even though ABORTVR was issued. 


Note that you can use this macro only in level 5. 


aa ee R—RCB= (regis ter) Sa ee 
name 


Parameters 


»>—RCB=(register) ———___-_-__________—— ae 


Function Specifies the register containing the address of the RCB for the 
resource that is undergoing virtual route activation. 


Format Register notation. 
Default None. 


Remarks Registers 0, 1, and 6 are not allowed. 
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ACHAIN—Add an Element to an ACHAIN 


The ACHAIN macro chains an element to either the head or the tail of an ACHAIN. 
An ACHAIN is a chain of elements to which an anchor block points. An anchor 
block may contain two pointers: one pointer points to the first element in the chain, 
and the other pointer points to the last element in the chain. However, the achain 
anchor block (AAB) may contain just a first pointer. Elements within an ACHAIN 
are usually control blocks, but they do not have to be control blocks. 


See NCP and EP Reference Summary and Data Areas, Volume 1, for more infor- 
mation on the AAB and the achain element block (AEB). 


Register 0 is not allowed for register parameters. 


Syntax 
p> —7 7 ACHAINAAB= (register) ,—AEB=(register) ,—WKREG= (register) -———_____________—__—_> 


name 
» TYPE=LAST 
=_ a 
~Luast 
»MODE=BOTH 
ee a 
~Letrst 
Sh re 
,AEBOFF=register 
Parameters 
>—AAB=(register) ££ —_""""" 
Function Specifies the register that contains the address of the AAB to which the 
new element is being chained. 
Format Register notation. 


Default None. 


Remarks The register specified must not be the same as the register specified foi 
AEB or WKREG. 
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>—AEB=(register) ,————A 


Function Specifies the register that contains the address of the AAB to be 
chained to the AAB. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
AAB or WKREG. 


>—WKREG= (register) 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
AAB or AEB. 


» TYPE=LAST 
os a 
Cast 


Function Specifies whether the element is to be chained to the head or tail of the 
ACHAIN. 


Format = FIRST or LAST. 
Default LAST. 
Remarks [If MODE=FIRST, the default for TYPE is FIRST. 


»MODE=BOTH 
= a 
Ez: IRST 


Function Specifies whether the AAB contains both a first and a last control block 
pointer, or just a first control block pointer. When MODE=BOTH, the 
AAB has pointers to both the first and last control blocks. 


Format BOTH or FIRST. 
Default BOTH. 


Remarks When MODE=FIRST, the AAB only contains a pointer to the first control 
block and the default for TYPE is FIRST. 
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Pd 

»AEBOFF=register 

Function Specifies the register containing the value that is the offset to the AEB 
within the control block to be chained. 

Format Register notation. 


Default No offset. 


Remarks AEBOFF=0 indicates that the embedded AEB is the first field in the 
control block to be chained. 


After the control block has been chained, the AAB chain pointers point 
to the beginning of the chained control blocks and not necessarily to the 
embedded AEBs. The AEB pointers point to the beginning of the next 
control block and not necessarily to the next AEB. 
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ACTVRIT—Activate an Internal Virtual Route 


Syntax 


The ACTVRIT macro generates an SVC. The macro activates an internal virtual 
route (VR) and returns an index into the virtual route vector table (VVT). In addi- 
tion, a code is returned indicating whether the virtual route was newly activated, 
was already activated, or could not be activated. 


Note that you can use this macro only in level 5. 
Register 0 is not allowed for register parameters. 


Warning: If you share a virtual route, remember that one user can deactivate the 
virtual route and destroy the sessions that other users have on that virtual route. If 
the response to the ACTVRIT macro shows that the virtual route is already active, 
try to start a different virtual route rather than use the virtual route that is currently 
active. SDLC monitor mode uses virtual route 7.2. 


seca (PT (ie T—RET=(register) ,—VVTI=(register) ,—VRID=(register) -__-_-__________—->» 


name 


Parameters 


>—ACTVRIT—RET= (register) ——_——_______ 


Function Specifies the register to contain the return code. The return codes are: 


X'00000' A new virtual route was created. 
X'00015' The virtual route was already active. 
X'00012' The virtual route was not activated. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
the VVT index (VVTI). 


>—VVT1=(register) A 


Function Specifies the register in which the VVTI is to be returned. The VVTI 
identifies the VRB assigned to the specified virtual route. A value of 
X'00000' is returned if the virtual route was not activated. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
RET. 
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>—VRID= (register )-——@ a 


Function Specifies the register containing the virtual route identification (VRID). 
The VRID consists of two values, the virtual route number (VRN) and 
the transmission priority field (TPF). The VRN value, 0 to 7, must be in 
byte 0 of the specified register. The TPF value, 0 to 2, must be in byte 
1 of the specified register. 


Format Register notation. 
Default None. 
Remarks Register 1 is not allowed. 
If the VRID value is not valid, the virtual route will not be activated. 


For internal virtual routes, the TPF has no effect on the flow of path 
information units (PIlUs), except for boundary buffer pool (BPOOL) allo- 
cation priorities. 


28 NCP, SSP Customization Reference LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” ADVAN 
Licensed Materials — Property of IBM 


ADVAN—Advance a Pointer to Next Queue Element 


The ADVAN macro returns a pointer to the next sequential element enqueued to a 
specified system queue. The element is not dequeued. 


Register 0 is not allowed for register parameters. 


Syntax 
>> —ADVAN— (posi tional_e Leman) 
name 
“Tigmeienenye =~=~S«C*CS~*‘“‘i‘i‘i‘“‘OSNSNSNCSNN’SSNO#‘“‘CSRSNSNNCO#*‘“‘(#NSSCN 
L LAST= Lobe1——— 
“LeGrenister) 
»NCP=NO 
— = 
~Lygs 
, SUPV=NO 
_— — 
Leyes 
Parameters 


»>—(positional_element )————£§$a£™O@ £ —— ———-——_ 


Function Specifies the register containing the address of the positional element in 
the queue. 


Format Register notation. 
Default None. 


Remarks If NCP=NO, register 1 is not allowed. 


E frien erenent)— 


Function Specifies a register that is to receive the address of the located element. 
Format Register notation. 


Default The address is returned in the register containing the positional element 
address. 


Remarks If NCP=NO, register 1 is not allowed. Register 4 is standard. 


The contents of the register specified are set to 0 if the positional 
element is the last element on the queue. 
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a LAST=—-labe —— 
Geet ter) 


Function Specifies an address to be branched to if the positional element is the 
last element on the queue. 


Format Register or label notation. 


Default None. 


»NCP=NO 
»NCP=——N 
a 


Function Specifies the type of code to be generated based on the issuer's 
storage protection key. NCP=YES specifies that inline code is to be 
generated. NCP=NO specifies that an SVC is to be generated. 


Format YES or NO. 
Default NO. 


Remarks Specify NCP=NO when your code is in the user area of storage with a 
protection key not equal to 0. 


» SUPV=NO 
, SUPV=——NO— 
= 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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AFIND—Scan ACHAIN and Return the Address of the Next ACHAIN 
Element 


The AFIND macro scans an ACHAIN and returns the address of the element in the 
chain that immediately precedes the element specified. 


Register 0 is not allowed for register parameters. 


Syntax 
ee IN AAB= (register) ,—AEB=(register) ,—WKREG= (register) ,—PREAEB= (register) ————————> 


name 
»NFND=SETZNC 
»NFND=——SETNC 
Bserz 
SETZNC 
L AEBOFF= (registers 


Parameters 


»>— AAB=(register) —@-@@@—————________——_- . 


Function Specifies the register that contains the address of the achain anchor 
block (AAB) to which the element is chained. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
AEB, WKREG, or PREAEB. 


>—AEB=(register) ,—--——@___ > 


Function Specifies the register containing the address of the achain element block 
(AEB) for which the preceding element is to be found. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
AAB, WKREG, or PREAEB. 


The AAB can have both a first and last control block pointer, or it can 
have only a first control block pointer. 


w= WK REGS (heey S Ler) ye 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. . 
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Format FRegister notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
AAB, AEB, or PREAEB. 


>—PREAEB= (register) ————___ > 


Function Shows the register in which the address of the preceding element is to 
be returned. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
AAB, AEB, or WKREG. 


sNFND=SETZNC 
— Ta 
SETZ 
SETZNC 
Function Specifies whether the C latch, the Z latch, or both are to indicate 
whether the specified element (AEB) was found in the ACHAIN. 


Format SETZ, SETNC, or SETZNC. 
Default SETZNC. 


Remarks: For SETZNC or SETZ, the Z latch is set to 1 if the AEB is not found or 
to O if the AEB is found. 


For SETZNC or SETNC, the C latch is set to 0 if the AEB is not found in 
the ACHAIN or to 1 if the AEB is found. 


LL AEBOFF= (register) 


Function Specifies a register that contains the offset to the AEB within the control 
block to be found. If you do not specify AEBOFF, the offset to the AEB 
is 0, indicating that the embedded AEB is the first field in the found 
control block. 


Format Register notation. 
Default No offset. 


Remarks After AFIND is finished, PREAEB contains the address of the preceding 
control block in the chain rather than the address of the preceding AEB 
in the chain. 
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ALLOCATE—Associate Buffers with a Virtual Route 


The ALLOCATE macro marks buffers (PIUs) received on a virtual route as being in 
the boundary buffer pool (BPOOL), VRPIU pool, or both, and associates the buffers 
with a virtual route. The buffers are marked with the virtual route vector table index 
(VVTI) of the virtual route on which they are received. The VVTI is placed in the 
buffer header. 


Register 0 is not allowed for register parameters. 


Syntax 
scam CONE iia Le al ee ed ee 
name “L(Geqisters 
,DO=BOTH 
,»DO0=——BOTH 
BPOOL 
VRPOOL 
ore 
» SUPV=NO 
Parameters 
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Function Specifies the register containing the address of the buffers (PIUs) to be 
allocated. 


Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. 


>—VVTI= label, 
“eal Sher) 


Function Specifies the VVTI of the virtual route with which the buffers (PIUs) are 
to be associated. 


Format Register or label notation. 
Default None. 


Remarks Register 1 is not allowed. 
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»>—VRBP= (register) 


Function Specifies the register containing the address of the virtual route control 
block (VRB) for the virtual route on which the buffers (PIUs) are 
received. 


Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. 


,D0=BOTH 

,D0=——BOTH 
BPOOL 
VRPOOL 


Function Specifies the pool to which the PIU should be allocated. BPOOL speci- 
fies that the PIU should be allocated only to the boundary buffer pool. 
VRPOOL specifies that the PIU should be allocated only to the inbound 
virtual route PIU pool. BOTH specifies that the PIU should be allocated 
to both. 


Format BPOOL, VRPOOL, or BOTH. 
Default BOTH. 


4 
, SUPV=NO 
Function Specifies that the issuer is running in level 5. 


Format NO. 
Default NO. 
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ANDIF—Provide a Logical AND for an IF Macro 
The ANDIF macro, used with the comparison format of the IF macro, provides a 
logical AND decision capability for an IF-THEN-ELSE program structure. 


The ANDIF macro may follow an IF, an ORIF, or another ANDIF macro. However, 
an IF macro must always begin the sequence. Also, because of unpredictable 
results, ensure that no program code is between the ANDIF macro and an imme- 
diately preceding or following program-structuring macro. 

Register 0 is not allowed for register parameters. 


Note: For efficiency, clarity, and better structure, use the IF macro with the AND 
or OR keyword rather than using the ANDIF macro. 


Syntax 


sacle CS Rs F—keyword1 ,—operator-——_———_____H]h]> 
name 


>—, | | >< 
keyword2 »format 


For a description of the keywords, see the IF macro description. 


Example 


IF RGTEMP,EQ,X'40',1 
ANDIF RGSTAT,EQ,X'88',I 
THEN x 


ELSE y 


ENDIF 
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ASCAN—Return the Next Element Address in an ACHAIN 


Syntax 


The ASCAN macro returns the address of the next element following the specified 
element in an ACHAIN. If the element is not in a chain or is the last element in the 
chain, an address of 0 is returned. 


Register 0 is not allowed for register parameters. 


a ON i a AEB= (register) ,—NEXT=(register) ——__S 
name 


Parameters 


» LAST=SETZNC 

, LAST=——SETNC 
SETZ 
SETZNC 


L AEBOFF= (ecisiens= 


»>— AEB=(register) —£——__ 


Function Specifies the register containing the address of the achain element block 
(AEB) for which the following element is to be found. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
NEXT. 


>—NEXT= (register) ——_——@@@WWW 


Function Shows the register to receive the address of the next AEB in the 
ACHAIN. 


Format Register notation. 
Default None. 


Remarks The register is set to 0 if the specified AEB is the last AEB in the 
ACHAIN or if the AEB is not currently in an ACHAIN. 


The register specified must not be the same as the register specified for 
AEB. 
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» LAST=SETZNC 

» LAST=——SETNC 
SETZ 
SETZNC 


Function Specifies whether the C latch, the Z latch, or both are to indicate 
whether the specified element (AEB) is the last in a chain. 


Format SETZ, SETNC, or SETZNC. 
Default SETZNC. 


Remarks For SETZNC or SETZ, the Z latch is set to 1 if the specified element is 
not the last AEB in the chain or to 0 if it is the last. 


For SETZNC or SETNC, the C latch is set to 0 if the specified element 
is not the last AEB in the chain or to 1 if it is the last. 


When the AEB is not in an ACHAIN, the latches are set the same as 
when the AEB is the last element. 


E AEBOEF2 (register) = 


Function Specifies a register that contains the offset to the AEB within the control 
block to be found. If you do not specify AEBOFF, the offset to the AEB 
is 0, indicating that the embedded AEB is the first field in the found 
control block. 


Format Register notation. 
Default No offset. 


Remarks After ASCAN is finished, NEXT contains the address of the next control 
block in the chain rather than the address of the next AEB in the chain. 
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ASHIFT—Shift a Field Left or Right 
The ASHIFT macro shifts a field left or right 2 bit positions. 


Syntax 
cog: i ar IFT—(register) , Uap ee 
name ~ Lstore 


Parameters 


»>—(register), 


Function Specifies the register that contains the address constant to be shifted. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 
Pores 
STORE 
Function LOAD specifies that the field is to be shifted to the left. STORE speci- 


fies that the field is to be restored to a 16-bit value and, therefore, 
shifted to the right. 


Format LOAD or STORE. 


Default None. 
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ATTACHVR—Associate a Session with a Virtual Route 


The ATTACHVR macro associates a session with a virtual route. The resource 
connection block (RCB) of the resource associated with the session is chained to 
the virtual route vector table (VVT) entry for the virtual route with which the session 
is associated. 


Note that you can use this macro only in level 5. 


Register 0 is not allowed for register parameters. 


Syntax 
aie a a La Label ——_7—. WIT I= (register) ,—RETCODE= (register }—————-__—» 
name eat ter) 
, SUPV=NO 
ere 
Parameters 


p>—RCB= label 
Be pee RS 


Function Specifies the address of the RCB associated with the virtual route. 
Format Register or label notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
the virtual route vector table index (VVTI). 


Neither register 1 nor register 6 is allowed. 


If the RCB's VVTI field is not 0 on input to ATTACHVR, ATTACHVR will 
fail with a return code of X'0004' 


>-—VVTI=(register) <_< > 


Function Specifies the register containing the VVTI to be stored in the RCB. 
Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
RCB. 


Neither register 1 nor register 6 is allowed. 


The VVTI must be right-justified in the register. 
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»>—RETCODE=(register })}————_ ox 


Function Specifies a register to contain the return code. The return codes are: 
X'0000' The macro executed successfully. 


X'0004' RCB is already associated with a virtual route, indicated by a 
nonzero VVTI field in the RCB. 


X'0006' RCB is not associated with this virtual route, but is associ- 
ated with another. 


X'0008' The virtual route is inoperative. 
Format Register notation. 
Default None. 


Remarks The register specified can be the same as the register specified for the 
VVTI or RCB keyword. 


Register 6 is not allowed. 
Racked 
, SUPV=NO 
Function Specifies that the issuer is running in level 5. 


Format NO. 
Default NO. 
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AUNCHAIN—Remove an Element from an ACHAIN 


Syntax 


The AUNCHAIN macro removes an element from an ACHAIN. The element can 
be removed from any position in the chain. 


Register 0 is not allowed for register parameters. 


pe AUC HAT — AAB= (register) ,—AEB= (register) ,—WKRG1=(register) ———___________> 


name 


Parameters 


, TYPE=FIRST 
E a 
»MODE=BOTH 
a 


L AEBOFF=(register)— 


>— AAB= (register) > 


Function Specifies the register containing the address of the achain anchor block 
(AAB) from which the element is to be removed. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
the achain element block (AEB), WKRG1, or WKRG2. 


>—AEB=(register) ,———— 


Function Specifies a register that contains the address of the element to be 
unchained, or the address to which the unchained element is to be 
returned. 
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Format 
Default 


Remarks 
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If TYPE=EXTRACT, AEB specifies the register that contains the address 
of the AEB to be unchained. If TYPE=FIRST or if TYPE is omitted, AEB 
specifies the register in which the address of the unchained element is 
to be returned. 


Register notation. 
None. 


The register specified must not be the same as the register specified for 
AAB, WKRG1, or WKRG2. 


The register remains unchanged if TYPE=FIRST or if TYPE is omitted 
and the ACHAIN is empty. 


AUNCHAIN zeroes the chain pointer field in the element that is 
unchained. 


>—WKRG1= (register) HT > 


Function 


Format 
Default 


Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. If TYPE=EXTRACT and the AEB specified is 
not found on the ACHAIN, or if TYPE=FIRST and there are no path 
information units (PIUs), this register will contain a return code of X'04'; 
otherwise, the register value will be 0. | 


Register notation. 
None. 


The register specified must not be the same as the register specified for 
AAB, AEB, or WKRG2. 


» EMPTY=SETZNC 

» EMPTY=——SETNC 
SETZ 
SETZNC 


Function 


Format 
Default 


Remarks 


Specifies whether the C latch, the Z latch, or both are to indicate 
whether the ACHAIN becomes empty after the specified element (AEB) 
is unchained. 


SETZ, SETNC, or SETZNC. 
SETZNC. 


For SETZNC or SETZ, the Z latch is set to 0 if the chain does not 
become empty or to 1 if the chain becomes empty. 


For SETZNC or SETNC, the C latch is set to 1 if the chain does not 
become empty or to 0 if the chain becomes empty. 


If the AEB specified is not on the ACHAIN, the latches are set as if the 
chain were empty. 
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L- wkRG2=(register)— 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. Code this keyword only when 
TYPE=EXTRACT. 


Format Register notation. 
Default None. 


Remarks The register specified must not be the same as the register specified for 
AAB, AEB, or WKRG1. 


» TYPE=FIRST 
— a 
Le irst 


Function Specifies whether the element is to be unchained from the head (FIRST) 
of the chain or from elsewhere (EXTRACT) in the chain. 


Format FIRST or EXTRACT. 
Default FIRST. 


»MODE=BOTH 
— aoa 
Ley RST 


Function Specifies whether the AAB contains both a first and a last control block 
pointer or just a first control block pointer. When MODE=BOTH, the 
AAB has pointers to both the first and last control blocks. When 
MODE=FIRST, the AAB contains only a pointer to the first control block. 


Format BOTH or FIRST. 
Default BOTH. 


LL AEBOFF=(register)— 


Function Specifies a register that contains the offset to the AEB within the control 
block to be found. If you do not specify AEBOFF, the offset to the AEB 
is 0, indicating that the embedded AEB is the first field in the found 
control block. 


Format Register notation. 
Default No offset. 


Remarks After the control block has been unchained, the AAB chain pointers 
point to the beginning of the a-chained control blocks and not neces- 
sarily to the embedded AEBs. The AEB pointers point to the beginning 
of the next control block and not necessarily to the next AEB. 
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BAL—Branch and Link 


The BAL macro generates a branch and link instruction to be used by the con- 


troller. 
Syntax 
ca OTE Ra ter ,—labe|—___-—__--—______—_—_—_—_—_—_— rv 
name 
Parameters 


>-—register ,—_______ oN 


Function Specifies the register used to store the return address. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 
»>—L abe. $Y 1 


Function Specifies the location to be given control. 
Format Label notation. 
Default None. 


44 NCP, SSP Customization Reference . LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” BFREVENT 
Licensed Materials — Property of IBM 


BFREVENT—Place an ECB on a Buffer Event Queue 


The BFREVENT macro places an event control block (ECB) on either the slow- 
down event queue or the CWALL event queue. The task specified in the ECB is 
triggered when the specified level of buffers is available. 


Note: If SUPV=YES, you must provide a valid save area. 


Syntax 
Crane eT con ead ee eee 
CWALL 
» SUPV=NO 
e SU —— 
Parameters 


»>—TYPE=——RESET—-, 
Eo 
WALL 


Function Specifies whether to trigger the task when NCP is not in slowdown 
(TYPE=COND) or when the buffer level is above the CWALL value 
(TYPE=CWALL). If TYPE=RESET, the buffer event is canceled. 


Format RESET, COND, or CWALL. 


Default None. 


p—B sec aae igs 8 (ge 
ECB 


Function Specifies whether the POINTER keyword is the address of the ECB or 
of the resource connection block (RCB) containing the ECB. 


Format RCB or ECB. 


Default None. 


»>—POINTER=——Labe ee 
 Etregister) 


Function Specifies the address of the RCB or ECB. 
Format Register or label notation. 

Default None. 

Remarks If SUPV=YES, label notation is not valid. 


Register 0 is not allowed. 
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» SUPV=NO 
ie “ane 
~Lyes 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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BHEXIT—Execute a Block Handling Routine 


The BHEXIT macro is used by the initiator and terminator subtasks to execute 
block handling routines (BHRs) at point 2. The generated code tests to see 
whether a BHR extension exists for the device associated with the device base 
control block (DVB) address, and if so, branches to the BHR check routine. 


The macro has three forms: list (MF=L), execute (MF=E), and stand-alone. The 
list form of the macro sets up the registers for the exit but does not do the actual 
exit; this form alters only the contents of register 1(0). The execute form of the 
macro does the actual exit; it alters the contents of registers 1,6, and 7. The 
stand-alone form of the macro combines the functions of the list and the execute 
forms; it also alters the contents of registers 1, 6, and 7. 


List (MF=L) Form 


Syntax 
eee EXIT—MF=L 
name 


Le iedister)— 


Parameters 
>—MF=L 


Function Specifies the list form of the macro. The list form sets up the registers 
for the exit, but does not do the actual exit. 


Format __L specifies list. 
Default If you omit this keyword, the stand-alone form is used. 


Remarks This keyword alters the contents of register 1(0). 
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a ipenisteny =| 


9 


Function Specifies the register containing the DVB address. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 


» FROM=RT 


Function Specifies the type of I/O subtask issuing the BHEXIT macro. 


Format Any one of R (read), W (write), C (contact), D (disconnect), and E 
(error), combined with | (initiator) or T (terminator). 


Default RT (read terminator), including display service-seeking terminator, 
common-read terminator, and read-entry point of chain terminator. 


Execute (MF=E) Form 


Syntax 


p> —___7 BHEXI T— (register) , ABORT = address——,—MF=E 
name ~Lyone——l 


Parameters 


L NOTPRES=address— 


>—(register), 


Function Specifies the register containing the DVB address. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 
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»—ABORT=—7-adaress—7—s 
NONE 


Function Specifies the address to be branched to if the BHR issues an ABORT 
macro with a nonzero completion code, or if the BHR removes the block 
control unit from the queue. 


Format NONE or label notation. 


Default None. 
Pre ee ee 


Function Specifies the execute form of the macro. The execute form does the 
actual exit. 


Format __E specifies execute. 
Default ‘If you omit this keyword, the stand-alone form is used. 


Remarks This keyword alters the contents of registers 1, 6, and 7. 


Bs NOTPRES=address— 


Function Specifies an address to be branched to if a BHR extension does not 
exist. 


Format Label notation. 


Default Branches to the next sequential instruction following the BHEXIT macro 
expansion. 


Stand-Alone Form 


The stand-alone form of the macro combines the functions of the list and execute 
forms. It alters the contents of registers 1, 6, and 7. 


Syntax 


p> —___ BHEXIT—(register) ,—ABORT= address 
name NONE 


Lo NOTPRES=address— : 
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»>—(register) 


Function Specifies the register containing the DVB address. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 


sm aaa aaa 
NONE 


Function Specifies the address to be branched to if the BHR issues an ABORT 
macro with a nonzero completion code, or if the BHR removes the block 
control unit from the queue. 


Format NONE or label notation. 
Default None. 
Remarks Specify ABORT=NONE when FROME=RI, WI, Cl, or DI. 


» FROM=RT 


Function Specifies the type of I/O subtask issuing the BHEXIT macro. 


Format Any one of R (read), W (write), C (contact), D (disconnect), and E 
(error), combined with | (initiator) or T (terminator). 


Default RT (read terminator), including display service-seeking terminator, 
common-read terminator, and read-entry point of chain terminator. 


L NOT PRES=address— 


Function Specifies an address to be branched to if a BHR extension does not 
exist. 


Format Label notation. 


Default Branches to the next sequential instruction following the BHEXIT macro 
expansion. 
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BLDR—Build a System Response 


I/O subtasks use the BLDR macro to build a phase 1, 2, or 3 system response in 
register 1(0) in program level 5. The macro combines the specified response code 
with either the current phase as contained in the system response field of the BTU 
(BCUSRES) or the specified phase given in the macro. The BLDR macro uses 
equates that are defined by the XXCXTRES macro. 


Syntax 
ee a See one 
name 


Es phases 


Parameters 


>—c 0de—__—_—_ 


Function Specifies the numeric code for the desired response. System responses 
define the codes to be used. Refer to the section on BTU responses in 
NCP and EP Reference Summary and Data Areas, Volume 2. 


Format Absolute notation. 


Default None. 


a phases 


3 


Function Specifies the desired phase of the response. 
Format 1, 2, or 3. 


Default The phase currently contained in the BTU system response field is 
used. 
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BLKENTRY—Describe a Block or a Table 


The BLKENTRY macro describes a block or a table that is pointed to, as a 
dependent, by a parent block previously described in the block dump table (BDT). 
The parent block could be described in either the GRPENTRY or another 
BLKENTRY macro. The BLKENTRY and GRPENTRY macros can be used by IBM 
special products or user-written code as an interface to the dump formatter. They 
provide control block pointers, lengths, and names so that IBM special products or 
user-written code control blocks can appear in a formatted NCP dump. 


Syntax 


me ee BLKENTRY BURNET tone »—7 LENG TH=block_ lengthy ——, OFFS ET=displacement-—7— ,—» 
name LENGTHE=block_length ~ Lores ETE=displacement 


>—ORIGIN=Label 
, TYPE=0 
—— 
, ADDR=FULL 
cariae 


Parameters 
Cages 


Function Referred to in the ORIGIN keyword of another (and dependent) 
BLKENTRY macro. 


Format Label notation. 
Default None. 


Remarks The label (name) is the name given to a macro that describes a parent 
block that points to a following dependent block. In the macro that 
describes the dependent block, the ORIGIN keyword contains the parent 
block macro label to complete the chained relationship. 


>—BLKNAME=label ,— 


Function Specifies the name of the block to be printed in the formatted dump; the 
name can be up to 5 characters long. 


Format Label notation; character string from 1 to 5 bytes long. 
Default None. 


Remarks The name is truncated if it is longer than 5 characters. 
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py LENGIHbLock_length 7s 
LENGTHE=block_length 


Function Specifies the block length. 


Format Decimal notation (LENGTH), or symbolic notation (LENGTHE); from 0 to 
252 bytes. 


Default None. 


Remarks Since symbolic expressions are not resolved during the macro expan- 
sion phase, cross-checking to ensure that pointers in this control block 
do not exceed the length of the control block is not done. 


mn ET=displacement-——, 
OFFSETE=displacement 


Function This is the offset location of the pointer within the parent block whose 
describing macro Is referred to in the ORIGIN keyword. The pointer 
contains the address of the block being described in this BDT entry. 


Format Decimal notation (OFFSET), or symbolic notation (OFFSETE); from 0 to 
252 bytes. 


Default None. 


Remarks Since symbolic expressions are not resolved during the macro expan- 
sion phase, cross-checking to ensure this offset does not exceed the 
length of the parent control block is not done. 


SRG NS SSS SSS SSS SSS 


Function Specifies the label (name) of another BLKENTRY or the GRPENTRY 
macro that describes a parent block that points to the dependent block 
being described in this BDT entry. 


Format Any name of a block previously described. 


Default None. 


» TYPE=0 
, TYPE= 
re 
Function Specifies whether a table or a block is to be described. 


Format 1 for a table; 0 for a block. 
Default 0. 
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» ADDR=FULL 
as Te 
~ CHALE 


Function Specifies whether the address of the block or table to be dumped is a 
halfword or a fullword. 


Format HALF for a halfword; FULL for a fullword (4 bytes). 
Default FULL. 
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Branch Macros—Branch Conditionally to a Specified Location 


Syntax 


Parameters 


All branch macros generate a series of conditional branches. The result is a 
branch to a specified location if a certain condition is met. The condition is the 
result of a compare operation or the result of an arithmetic or logical operation. 


The BAL branch macro, which is described on page 44, is not included in this 
section because it is formatted differently than the macros discussed here. 


Table 5 shows the branch macros that have the same format. 


Table 5. Branch Macro Conditions 


Macro Condition for Branching 

BCR The C condition latch is on after an arithmetic or logical operation. The 
branch address must be specified in register notation. . 

BH A is greater than B after comparing A and B. 

BM The result is negative after an arithmetic or logical operation. 

BMZ The result is negative or 0 after an arithmetic or logical operation. 

BNC The C condition latch is not on after an arithmetic or logical operation. 

BNDH The result is a branch-to-address within the low 64KB of storage. 

BNE A is not equal to B after comparing A and B. 

BNH A is not greater than B after comparing A and B. 

BNL A is not less than B after comparing A and B. 

BNZ The Z condition latch is not on after an arithmetic or logical operation. 

BP The result is positive after an arithmetic or logical operation. 

BPZ The result is positive or 0 after an arithmetic or logical operation. 

BZR The Z condition latch is on after an arithmetic or logical operation. The 


branch address must be specified in register notation. 


>> —-——_,—branch_macro— (branch_address )}——"_ > 
name 


»—(branch_address )——___________ + 


Function Specifies the location to be given control if the condition is met. 
Format Register or label notation. 
Default None. 


Remarks Register 0 is not allowed. 
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BTDELETE—Delete a Node from a Binary Tree 


The BTDELETE macro deletes a node or search element control block (SEB) from 
a binary search tree. 


You can use register 7 as an input register, but the contents may not be preserved. 
Register 6 must point to a valid save area. Register 0 is not allowed. 


On exit, register 1 contains one of the following return codes: 


X'00000' The SEB was successfully deleted from the tree. 

X'00001' An SEB with the specified key was not found. This return code indi- 
cates a severe problem with the tree that must be corrected. 

X'00002' The specified SEB is not in a search tree. 


Syntax 
re—___BIDELETE—SHB= (register) a so 2 ee a ars 
name KEY=(rx,ry) 


,NCP=NO 
cs 
, SUPV=NO 
— 


Parameters 


»>—SHB=(register) ,——_  — 


Function Specifies the register containing the pointer to the search header block 
(SHB) that anchors the tree. 


Format Register notation. 
Default None. 


Remarks The register specified cannot be used for any other keyword. 
>—SEB= (register) 


Function Specifies the register containing the pointer to the SEB. 
Format Register notation. 
Default None. 
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Remarks 


BTDELETE 


You must specify either an SEB pointer or provide a search key, but not 
both. 


You must code SEB rather than KEY if checking is required to deter- 
mine whether the SEB is in a search tree before deletion processing 
begins (indicated by a return code of X'00002'). 


The register specified cannot be used for any other keyword. 


>—KEY=(rx , ry) 


Function 


Format 
Default 
Remarks 


Specifies the two registers to contain the 4-byte key of the SEB to be 
deleted. The rx register contains the first 2 bytes, and the ry register 
contains the second 2 bytes. 


Register notation. 
None. 


You must specify either an SEB pointer or provide a search key, but not 
both. 


The register you specify must not be the same as the register specified 
for any other keyword. 


»NCP=NO 
sNCP=——N 
= 


Function Specifies the type of code generated based on the issuer's storage pro- 


Format 
Default 


tection key. NCP=YES specifies that the issuer is running in NCP 
storage protection key 0; inline code is generated. NCP=NO specifies 
that the issuer is running in NCP storage protection key 1; SVC code is 
generated. 


YES or NO. 
NO. 


Remarks Specify this parameter only when SUPV=NO. 


, SUPV=NO 
, SUPV=——NO 
= 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 


Format 
Default 


that the issuer is running in level 5. SUPV=YES indicates that the 
issuer iS running in an interrupt level. 


YES or NO. 
NO. 
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BTECHECK—Check Whether a Binary Tree Is Empty 


Syntax 


The BTECHECK macro checks a binary tree to see if it is empty. 


On exit, register 1 contains one of the following return codes: 


X'00000' The binary tree is empty. 
X'00001' The binary tree is not empty. 


Register 6 must point to a valid save area. Register 0 is not allowed. 


pe 7 BT ECHECK—SHB= (register) $$$ > 
name 


Parameters 


,NCP=NO 
—s 
,SUPV=NO 

E —— 


»>—SHB= (register) ££ —_—_ > 


Function Specifies the register containing the pointer to the search header block 
(SHB) that anchors the tree. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as the register specified 
for any other keyword. 


»NCP=NO 
FE »NCP= =e 
“LY¥Es 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES specifies that the issuer is running in NCP 
storage protection key 0; inline code is generated. NCP=NO specifies 
that the issuer is running in NCP storage protection key 1; SVC code is 


generated. 
Format YES or NO. 
Default NO. 


Remarks Specify this parameter only when SUPV=NO. 
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» SUPV=NO 
aera 
YES 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES indicates that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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BTINSERT—Insert a Node into a Binary Search Tree 
The BTINSERT macro inserts a node search element control block (SEB) into a 
binary search tree. 


Use register 7 as an input register, keeping in mind that this is a volatile storage 
area. Register 6 must point to a valid save area. Register 0 is not allowed. 
On exit, register 1 contains one of the following return codes: 


X'00000' The SEB was successfully inserted to the tree. 

X'00001' An SEB with the specified key was already in the tree. This return code 
indicates a severe problem with the tree that must be corrected. 

X'00002' The search tree header control block (SHB) future key field was never 
initialized. 


Syntax 
>> — 7 BTINSERT—SHB= (register) ,—SEB= (register) ,—KEY=(rx, ry) 


name 
» GENKEY=N 
=e = 
Lys 


, SUPV=NO 
— 2 
| Lys 


Parameters 


»>—SHB= (register) 


Function Specifies the register containing the pointer to the SHB that anchors the 
tree. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as the register specified 
for any other keyword. 
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BTINSERT 


»>—SEB=(register) ,_@£ 


Function 
Format 
Default 


Remarks 


m>—KEY=(rx, 


Function 


Format 
Default 


Remarks 


Specifies the register containing the pointer to the SEB to be inserted. 
Register notation. 
None. 


The register you specify must not be the same as the register specified 
for any other keyword. 


lS SSS 


Specifies which registers are to be put in the SEB. If GENKEY=NO, 
KEY specifies the registers containing the search key to be put in the 
SEB. If GENKEY=YES, KEY indicates that the registers will contain an 
NCP-generated key value that is put in the SEB on return from 
BTINSERT. The x register contains the high 2 bytes of the key, and 
the ry register contains the low 2 bytes. 


Register notation. 
None. 
The two registers specified can only be used for this keyword. 


You cannot use register 1 if GENKEY=YES is specified. 


, GENKEY=N 
=" a 
Les 


Function 


Format 
Default 


Specifies whether NCP is to generate the search key for this SEB. If 
GENKEY=YES, NCP will generate a search key and assign it to the 
SEB. 


YES or NO. 
NO. 


»NCP=NO 
- a 
Lys 


Function 


Format 
Default 


Remarks 


Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES specifies that the issuer is running in NCP 
storage protection key 0; inline code is generated. NCP=NO specifies 
that the issuer is running in NCP storage protection key 1; SVC code is 
generated. 


YES or NO. 
NO. 
Specify this parameter only when SUPV=NO. 
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» SUPV=NO | 
os “a 
Lys 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES indicates that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 


62 NCP, SSP Customization Reference LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” BTSEARCH 
Licensed Materials — Property of IBM 


BTSEARCH—Search a Binary Tree 


Syntax 


The BTSEARCH macro finds a node search element control block (SEB) in a 
binary search tree. 


Use register 7 as an input register, keeping in mind that this is a volatile storage 
area. Register 6 must point to a valid save area. Register 0 is not allowed. 
On exit, register 1 contains one of the following return codes: 


X'00000' An SEB with a key equal to KEY was found. 
X'00001' No SEB with the specified key was found. 


cies (OR ie (register) ,—KEY=(rx, ry) ,—CBPTR=(register)—_—_—_—____________—__—_> 


name 


Parameters 


a WORKR= (ee orkred iste ae 
» INLINE=N 
E — 
»NCP=NO 
x 
, SUPV=NO 
- SU = 


>—SHB=(register) ,—-—-@ —_——_ 


Function Specifies the register containing the pointer to the search header block 
(SHB) that anchors the tree. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as the register specified 
for any other keyword. You cannot use register 6. If you specify 
INLINE=YES, you cannot use register 1. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 | Chapter 2. Macro Directory 63 


BTSEARCH 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


>—KEY=(rx ry), eT 


Function Specifies the two registers to contain the 4-byte key of the SEB to be 
found. The rx register contains the first 2 bytes, and the ry register con- 
tains the second two bytes. KEY is set to 0 if no matching SEB is 
found. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as the register specified 
for any other keyword. You cannot use register 6. If you specify 
INLINE=YES, you cannot use register 1. 


>—CBPTR=(register) 


Function Specifies the register to contain a pointer to the SEB's outer control 
block if the SEB is found. The register is set to 0 if no SEB is found. 


Format Register notation. 
Default None. 


Remarks The register you specify can be the same as the register specified for 
SHB or KEY. You cannot use register 1 or register 6. 


L WORKR= (CE sorkiregis te = 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default No work registers. 


Remarks You can code any or all of the following registers: 1, 2, 3, 4,5, or 7. 
You can code WORKER only when INLINE=YES. 


» INLINE=N 
ae a 
| ~Lyes 
Function Specifies whether inline linkage code is generated. 
Format YES or NO. 


Default NO. 


Remarks You can specify this parameter only if you do not code NCP. If you 
code INLINE, you must include the XBTSPLST DSECT. Specifying 
INLINE=YES along with WORKR is recommended for performance 
reasons; however, you cannot use register 1 for SHB, KEY, or CBPTR. 
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»NCP=NO 
»NCP=——N 
= 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES specifies that the issuer is running in NCP 
storage protection key 0; inline code is generated. NCP=NO specifies 
that the issuer is running in NCP storage protection key 1; SVC code is 
generated. Note that specifying INLINE=YES is recommended for per- 
formance reasons when SUPV=YES, unless register 1 must be used for 
SHB, KEY, or CBPTR. 


Format YES or NO. 
Default NO. 


Remarks Do not specify NCP if you code SUPV=NO and INLINE. Specifying 
INLINE=YES rather than NCP=YES is recommended for performance 
reasons, unless register 1 must be used for SHB, KEY, or CBPTR. 


, SUPV=NO 
E SUPV= ao 
Les 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES indicates that the 
issuer iS running in an interrupt level. 


Format YES or NO. 
Default NO. 
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BUFCHK—Check if Address Is in Buffer Pool 
For NCP V7R1 or V7R1F and later versions, the BUFCHK macro checks to see if 
an address is within the range of the buffer pool. 
Do not specify the same register for more than one keyword. 


Register 0 is not allowed for register parameters. 


This macro generates inline code. 


Note: You must invoke the XDA DSECT macro XCXTXDA and the XDB DSECT 
macro XCXTXDB in the routine that issues the BUFCHK macro. 


Syntax 


acaael lena FCHK—ADDR=(register) ,—OUTPUT=(byte_register) ,—WORKR=(odd_register) —_------»« 
name 


Parameters 


>—ADDR= (register) <——__$S : 


Function Specifies the register containing the address that should be checked to 
see if it is within the buffer pool range. 


Format Register notation. 
Default None. 


Remarks Register 6 is not allowed. 
>—OUTPUT=(byte_register) ,——— 


Function Specifies a byte register that will contain the following output: 


X'00' The address was within the buffer pool. 
X'01' The address was not within the buffer pool. 


Format Byte register notation. 


Default None. 


>—WORKR=(odd_register )——@—_—_ >< 


Function Specifies an odd-numbered work register, the contents of which may be 
altered during execution of the macro. 


Format Register notation. 
Default None. 


Remarks Must be an odd-numbered register. 
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BUILDPIU—Build a Prototype PIU 


The BUILDPIU macro builds a prototype path information unit (PIU) in an inline 
buffer, not in a buffer from the buffer pool. To build a PIU with the BUILDPIU 
macro, use a sequence similar to the following: 


LA 3,name Puts BUILDPIU name in R3 


* 
* Fill in UnOFFSET and UnDATCNT fields. 


* 


COPYPIU§ (3),(4),...,LEASE=YES R3 points to the inline buffer and 
R4 points to a new buffer 


B label 
name BUILDPIU keywords 
label EQU * 


The COPYPIU macro with LEASE=YES leases a buffer from the buffer pool and 
copies the prototype PIU into the buffer. Fields such as OAF, DAF, and SNF 
should be updated with the appropriate values before the copied PIU is transmitted. 
The buffers ECB is initialized appropriately; all other fields between the buffer 
prefix and THBO are set to 0. 


Syntax 
ee ee 
name 


“T] & G Poe 


aac 
, THB1=hex_value 
a 
, THDAF=hex_value : 
ni es 
» THOAF=hex_value 
lsd 
» THSNF=hex_value 
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, THDCF=0 
eee 
,RHBO=(REQ, FM, WITH, FMATTED, NOSENSE, ONLYCHN) | 
, RHBO=——hex_value 
RH Byte 0 Settings 
, RHB1=0 
,RHB1=—,—hex_value 
RH Byte 1 Settings 
, RHB2=0 
, RHB2=——hex_value 
RH Byte 2 Settings : 


, RUBTO=—;—hex_value 
~Lactpu 


» RUBT1=—,—hex_value 
ERP 


»RUBT2=hex_value 


» RUDATA=text 


RH Byte 0 Settings: 


RE F WITH FMATTE NOSENSE 
t—( 9 9 ) 9 aaa 
RE DFC WITH FMATTE NOSENSE 
RSP F AGAINST UNFMAT SENSE 
NC | | 
SC 


RH Byte 1 Settings: 


ane 


Pal 
FME, PE, RRN, EXR, RETRY, LWR, PACE 


RH Byte 2 Settings: 
—— 


BGNBKT, ENDBKT, CHGDIR, RQCHGDIR, LOGGING 
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Parameters 


>—FID= 


™T) & GW NO 


Function Specifies the PIU format identifier (FID) type to be built. 
Format Absolute notation. 
Default None. 


Remarks lf the absolute notation is not in the range of 0 to 4 or if the value or 
keyword is omitted, no PIU is built and an MNOTE is issued. 


» THBO=0 
, THBO=——hex_value 
a NLYSEG 0 
( fat 
EXP 
0 


Function Specifies the segment and data flow conditions for the PIU to be built (in 
byte 0 of the transmission header), or the value of byte O of the new 
PIU. 


Format FRSTSEG, LASTSEG, MIDSEG, or ONLYSEG, followed by either EXP 
or NORM, both enclosed in parentheses and separated by a comma. 
Use absolute hexadecimal notation for byte 0 of the transmission 
header. 


Default X'00', ONLYSEG, or NORM. 


Remarks FRSTSEG, LASTSEG, MIDSEG, and ONLYSEG refer to segments of a 
PIU too large for a cluster controller or device buffer (not to be confused 
with an NCP buffer). 


na 
, 1HB1=hex_value 


Function Specifies the second byte (byte 1) of the new PIU. 


Format Absolute hexadecimal notation. 
Default X'00'. 
Remarks Not valid for FID type 3. 
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enn 
» THDAF=hex_value 
Function Specifies the destination address field (DAF) of the new PIU. 


Format Absolute hexadecimal notation. 
Default X'0000' for all, except FID type 2, for which it is X'00'. 


» THOAF=0 
E THOAF ee 
Function Specifies the origin address field (OAF) of the new PIU. 
Format Absolute hexadecimal notation. 


Default X'0000' for all except FID type 2, for which it is X'00'. 
Remarks Not valid for FID type 3. 


» THSNF=0 
pecan 
Function Specifies the sequence number field (SNF) of the new PIU. 
Format Absolute hexadecimal notation. 


Default X'0000'. | 
Remarks Not valid for FID type 3. 


Peace 
, THDCF=hex_value 
Function Specifies the data count of the new PIU. This count is equal to the sum 


of the length of the request/response header (RH) and the 
request/response unit (RU) fields of the new PIU. 


Format Absolute hexadecimal notation. 
Default X'0O000'. 
Remarks Not valid for FID types 2 or 3. 
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BUILDPIU 
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,RHBO=(REQ, FM, WITH, FMATTED, NOSENSE, ONLYCHN) 
,RHBO=——hex_value 
RH Byte 0 Settings 


RH Byte 0 Settings: 


RE F WITH FMATTE NOSENSE 
et Goel Gaeta Bagge 
RE DFC WITH FMATTE NOSENSE 
RSP F AGAINST UNFMAT SENSE 
NC 
SC 


) 


Function Specifies byte 0 of the RH field. 


Format Absolute hexadecimal notation. 
Default REQ, FM, WITH, FMATTED, NOSENSE, and ONLYCHN. 
Remarks The meanings of the keywords are: 
REQ Request PIU 
RSP Response PIU 
SC Session control 
NC Network control 
FM Function management data 
DFC Data flow control 
WITH With flow 
AGAINST Against flow 
FMAT TED Formatted data 
UNFMAT Unformatted data 
SENSE Sense data included 
NOSENSE Sense data not included. 


FRSTCHN, LASTCHN, MIDCHN, and ONLYCHN refer to elements in a 


series of PIUs. 


»RHB1=0 
»RHB1=——hex_value 
RH Byte 1 Settings 


RH Byte 1 Settings: 


i She ne 
FME, PE, RRN, EXR, RETRY, LWR, PACE 


Function Specifies the second byte of the RH field of the new PIU. 


Format 


Default X'00'. 
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Remarks The meanings and values of the keywords are: 


FME Function management END or DR1 requested or sent, 
value: X'80' 

PE Path error requested or sent, value: X'40' 

RRN Relative-record number or DR2 requested or sent, value: 
X'20! 

EXR Exception response, value: X'10' 

RETRY Retry or BUSY requested or sent, value: X'08' 

LWR Larger window requested, value: X'04' 

PACE PACE requested or sent, value: X'01'. 


, RHB2=0: 
, RHB2=——hex_value 
RH Byte 2 Settings 


RH Byte 2 Settings: 
oe ee ee 
BGNBKT, ENDBKT, CHGDIR, RQCHGDIR, LOGGING 


Function Specifies the third byte of the RH field of the new PIU. 
Format Absolute hexadecimal notation. 

Default X'00'. 

Remarks The meanings of the keywords are: 


BGNBKT Begin bracket 

ENDBKT End bracket 

CHGDIR Change direction 
RQCHDIR Request change direction 
LOGGING Logging. 


»RUBT0=——hex_value 
Lact PU 


Function Specifies the first byte of the RU. 
Format Absolute hexadecimal notation. ACTPU results in a value of X'11'. 
Default X'00'. 


& RUBT1=—-~hex_value— 
ERP 


Function Specifies the second byte of the RU field. 
Format Absolute hexadecimal notation. 
Default X'0O0O'. 
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a RUBT2=hex_value— 


Function Specifies the third byte of the RU field. 
Format Absolute hexadecimal notation. 
Default X'00O'. 


LL RUDATA=text— 


Function Specifies the text field. 
Format Absolute hexadecimal notation. 
Default X'0OO'. 


Remarks BUILDPIU will not ensure that the PIU that is built is within proper buffer 
boundaries. 
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CAlO—Generate Channel Adapter Input or Output 


The CAIO macro generates a channel adapter input or output instruction to be used 
by the communication controller. 


Syntax 
er reo eee) s—(ca_register) , gy im A) ea 
name ~ Lor ta_equate 


» YES 
oN 
— 


Parameters 


>—(register) ,—_—_________———— 


Function Specifies any of the eight general-purpose registers 0 through 7. 
Format Label notation. 
Default None. 


Remarks Labels for registers are defined in the System Register Equates in the 
XSYSEQU DSECT macro. 


»>—(ca_register) ,————___cccr— ; 


Function Specifies the channel adapter external register to be read in or written 
out. 


Format Label notation. 
Default None. 


Remarks Labels for channel adapter external registers appear in the System Reg- 
ister Equates in the XSYSEQU DSECT macro. 


Register 0 is not allowed. 


a 


Function Specifies the type of operation to be carried out as input or output. IN 
indicates an input or a read operation. OUT indicates an output or a 
write operation. 


Format IN or OUT. 


Default None. 
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sa hao | aaa aaa aaa aaa 
ta_equate 


Function Passes the high byte of the tag address data, including the bus bit. This 
is passed either in the high byte of an odd-numbered register or as a 
byte equate. 


Format Label notation if a register; byte equate notation if tag address (TA) 
equate. 


Default None. 


Remarks If the high byte of the tag address is passed in a register, you must use 
an odd-numbered register and the high byte of the tag address must be 
in the high byte of the register. 


Register 0 is not allowed. 


xYES 
E — 
Lyes 


Function Specifies whether the adapter input/output halfword (l1OH) trace is to be 
called. YES indicates that the trace is to be called. NO indicates that it 
is not to be called. 


Format YES or NO. 
Default YES. 
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CALL—Transfer Control to a Subroutine 


Syntax 
Lanes ie 


Parameters 


The CALL macro transfers control to a specified subroutine. The macro structures 
a save area or refers to a previously defined save area if the call is toa 
nonreentrant subroutine; or the macro allocates a dynamic save area if the call is to 
a reentrant subroutine. The macro saves the specified registers. 


Register 0 is not allowed for register parameters. 


Note: Use the SUBRTN macro to define the entry point of routines to be called by 
CALL. 


subrout tena $< 
(register) 


L pees | 


, SAVE= 


savearea 
ea 
(fecister—) 
»ATTR=NONREENT: 
a — aa 
~CREENT— 


L ENTRY-entry_point— 


SO 
(register) 


Function Specifies the name of the subroutine to be invoked. 
Format Register or label notation. 

Default None. 

Remarks Register 1 is not allowed. 


If you use label notation, the symbol must be the same as the name 
field of the SUBRTN macro that defines the subroutine. 
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L (parame ne 


Function Specifies the parameters to be passed as arguments from the calling 
program to the subroutine. 


Format Symbolic names, coded within parentheses and separated by commas. 


Default None. 


Function Specifies whether the subroutine being called is a strong external (V) 
reference, a local (A) reference, or a weak external (W) reference. 


Format __V, A, or W. 


Default A. 
Remarks If you specify the subroutine name in register notation, this keyword is 
ignored. 


, SAVE= 


Savearea 
es 
Gs feoister) 


Function Specifies either the symbolic name of a previously defined save area 
(defined by a SAVEAREA macro) or the registers that are to be saved 
before invoking the subroutine. 


Format Label notation or registers. 
Default No registers are saved. 
Remarks lf ATTR=REENT, you cannot specify this keyword in label notation. 


In a series in which registers rx and rn specify the limits of the registers 
to be saved, the limits must be in ascending sequence, and INCL must 
be coded. In a random grouping, each register (rx,ry,...rn) must be 
specified. 


Register 1 cannot be saved. 
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» ATTR=NONREENT 
e ATTR=——NON a 
CRE ENT 


Function Specifies whether the subroutine being invoked is reentrant or 
nonreentrant. 


Format REENT or NONREENT. 
Default NONREENT. 


= ENTRY=entry_point— 


Function Specifies an optional entry point for the subroutine. 
Format Label notation. 
Default None. 


Remarks If you specify the subroutine name in register notation, this keyword is 
not valid. 
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CASE—Begin a Case Program Structure 


Syntax 


name 


Parameters 


The CASE macro is used with the CASEIF, CASENTRY, CASEXIT, and ENDCASE 
macros to form a case program structure. The CASE macro specifies the starting 
point of a case routine, which may be entered from one or more CASEIF macros 
following a CASENTRY macro. CASEIF macros following a different CASENTRY 
macro cannot enter this particular case routine unless the EQU keyword is used. 
The end point of the case routine is specified by the ENDCASE macro. 


Note: A CASE macro not equated to another CASE macro may have several 
CASE macros equated to it. An equated CASE macro must immediately follow the 
CASE macro to which it is equated before any instructions or the ENDCASE macro 
for the original CASE. CASE macros equated to another CASE macro share a 
single ENDCASE macro. 


B 
BL 
EXTRN 


x EQU=label— 


B 
BLG 
EXTRN 


Function Overrides the return function specified by the RTRN keyword of the 
CASENTRY macro. This parameter is valid only when B or BLG or the 
default has been specified by the RTRN keyword of the CASENTRY 
macro. 


Format _B specifies that a B instruction is to be used to return to CASEXIT. 
BLG specifies that a BLG instruction is to be used to return to CASEXIT. 
EXTRN specifies that the CASE routine is in another CSECT. 


Default The return function specified by the RTRN keyword of the associated 
CASENTRY macro is used. 


Remarks If you use the EQU keyword, do not specify this parameter. 
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Le EQU=labe a 


Function Equates this CASE macro with an immediately preceding CASE macro 
that has an identical return function. The return function is specified 
either by the return parameter of the CASE macro or by the CASENTRY 
RTRN keyword. The equated CASE macros can be entered from the 
same or different CASENTRY macros. If an equated CASE macro is 
entered from different CASENTRY macros, the RTRN keyword of the 
CASENTRY macros must specify (EXIT, SUPV), RESTORE, or (BR, 
register). 


Format To equate a CASE macro to another, give this keyword a value equal to 
the label of the appropriate CASE macro. That CASE macro must not 
also be equated to another CASE macro. 


Default No equate. 
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CASEIF—Test for a Condition in a Case Program Structure 


The CASEIF macro is used with the CASENTRY, CASEXIT, CASE, and ENDCASE 
macros to form a case program structure. The CASEIF macro tests for a specified 
condition and, if the test is true, branches to the specified case routine associated 
with the current CASENTRY and CASEXIT macro pair. After the case routine is 
executed, control returns to the point established by CASEXIT, except when the 
RTRN keyword on the CASENTRY macro specifies (EXIT, SUPV), RESTORE, 
SYSXIT, OR (BR, register). The CASEIF macro has the same functions as the IF 
macro. See NCP and SSP Customization Guide for additional information. 


See the description of the IF macro on page 176 for the keywords for these 
formats: 


e Test CL, ZL 

e Branch-on-bit 

e Test-under-mask 
e Comparison. 


Also refer to the description of the IF macro, comparison format, on page 181, fora 
description of the function, format, default, and notes for the following CASEIF 
parameters. If none of these parameters is specified, the CASEIF macro uncondi- 
tionally branches to the specified case routine. 


e keyword! 

° operator 

e keywora2 

e format 

e logical connective. 


Register 0 is not allowed for register parameters. 


Syntax 


sce a aS mar AL aa aaa 
name 


2 ian caiceonnee dive 


,»CASE=——label 
(B, label) 
(BLG, Label) 


Parameters 


,CASE=—— label 
EG, aber) 
(BLG, Zabel) 


Function Specifies the label of a case routine and, optionally, whether entry is 
through use of a B instruction or a BLG extended mnemonic. When you 
specify the label alone, the branch instructions used in the CASEIF 
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macro test are used to enter the case routine. If you do not specify this 
keyword, you can specify a logic operator to create a complex test for 
entry to the case routine specified on the last CASEIF macro in such a 
test. 


label specifies the label of the case to be executed using the default 
branch. 


(B, label) specifies that a B instruction is to be used to branch to the 
case routine specified by label. 


(BLG, label) specifies that a BLG extended mnemonic is to be used to 
branch to the case routine specified by label. 


Remarks You must specify the CASE and logic operator keywords under a single 
CASEIF macro. The last CASEIF macro in a complex multiple test must 
have the CASE keyword specified and the logic keyword blank; you 
cannot have both of these keywords blank. 
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CASENTRY—Begin Case Selection Criteria 


The CASENTRY macro is used with the CASEIF, CASEXIT, CASE, and ENDCASE 
macros to form a case program structure. The case program structure standard- 
izes the structure of decision logic and makes the program easier to read and 
maintain. CASENTRY establishes the starting point of CASEIF macro tests used to 
enter case routines defined by CASE and ENDCASE macros. 


Syntax 
a ENTRY—IF ,—TEST 
name 


IF and TEST are required dummy keywords. 


Parameters 


Function Specifies the return function used when an ENDCASE macro is 
encountered. 


Format _ B specifies that the B instruction will be used at the end of the case 
routines. 


BLG specifies that the BLG extended mnemonic will be used at the end 
of the case routines. 


RESTORE specifies a RESTORE macro with AREA=NO. Return is 
through the save area return address. The save area pointer is 
assumed to be in register 6. Note that CASENTRY does not save the 
return address for the case structure. 


SYSXIT shows that no further processing is required in the current level 
5 routine after processing the CASE macros. 


(EXIT,SUPV) specifies that no further processing is required in the 
current interrupt level after processing the case routines. This is not 
allowed in program level 5. Note that this format makes your code 
unstructured and must be used carefully. 


(BR, register) specifies that the return is with a BR instruction, and the 
return address is in the register specified by register. 
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Default BB. 


Remarks CASENTRY IF,TEST precedes one or more CASEIF macros that select 
the case routine to be executed. Each CASE macro has a label, and 
the appropriate case routine is entered from those CASEIF macros that 
specify the case routine label. 


The CASENTRY macros can be nested and may occur within a CASE 
(between CASE and ENDCASE). 


The B or BLG return functions can be overridden by the return type 
coded on the CASE macro. 


Register 0 is not allowed for the register parameter. 
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CASEXIT—End Case Selection Criteria 


The CASEXIT macro is used with the CASEIF, CASENTRY, CASE, and ENDCASE 
macros to form a case program structure. The CASEXIT macro establishes the 
end point of CASEIF testing. The end point determines the particular case routine 
that should be executed. After a case routine is executed, control is returned to the 
end point specified by CASEXIT, except when the RTRN keyword on the 
CASENTRY macro specifies (EXIT, SUPV), SYSXIT, RESTORE, or (BR, register). 


Syntax 
ee ee EXIT 
name 
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CHAIN—Add a Buffer to a Buffer Chain 


The CHAIN macro connects a buffer to a specified position in an existing buffer 
chain. This macro has two distinct formats: SUPV=YES denotes that the issuer is 
operating in an interrupt level, and SUPV=NO denotes that the issuer is operating 
in level 5. 


The macro is sometimes used to connect a chain of buffers to the end of an 
existing buffer chain. The CHAIN macro cannot, however, add a chain of buffers to 
the middle of an existing chain. 


Register 0 is not allowed for register parameters. 


SUPV=YES Format (Generates Inline Code) 


Syntax 
>> — —___7 CHAIN— (posi tional_puffer) »—(chain_buf fer) ,—SUPV=YES———_ A > 
name 


, END=NO 
, END=——-N 
= 
= (* ork regis ee 
, DIAG=NO 
7 DIAG= ~— 
~Lyes 


Parameters 


»>—(positional_buf fer) <> 


Function Specifies the register containing the address of the buffer to which the 
new buffer is to be chained. 


Format MRegister notation. 
Default None. 
Remarks Register 1 is not allowed. 


This value is not necessarily a pointer to the beginning of a path infor- 
mation unit (PIU), but is a pointer to the actual buffer to which the new 
buffer should be chained. 


>—(chain_buf fer) 


Function Specifies the register containing the address of the buffer to be chained. 
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Format Register notation. 
Default None. 
Remarks Register 1 is not allowed 
If END=NO, this chained buffer must be a single buffer. 


SSS SSS SS SESE SS SSS ee 


Function Specifies that the issuer is running in an interrupt level. 
Format YES. 


Default None. 


» END=NO 
E END= ar 
Lys 


Function Specifies whether the new buffer is a single buffer or a buffer chain that 
is to be chained to the end of an existing chain. 


END=YES specifies that the new buffers will be chained at the end of 
an existing chain, which must be pointed to by positional buffer 
address register. END=NO specifies that a single buffer is to be 
chained following a user-specified buffer in the existing chain. The user- 
specified buffer can be at any position. 


Format YES or NO. 
Default NO. 


Remarks If END=YES, positional buffer address register must point to the 
last buffer of the chain to which the new buffers are being added. 


L WORKR= (6 rk_registe a) 


Function Specifies work registers, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 


Default None. 


» DIAG=NO 
= = 
Les 


Function Specifies whether the buffer address and location will be logged in the 
ABN diagnostic area if an abend occurs. 


Format YES or NO 
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Default NO 
Remarks If YES is specified, the assembly must include dsect XCXTABN. 
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SUPV=NO Format 


Syntax 


>> — CHAIN (positional_buffer) ,—(chain_buffer) ,<—@@ —_—__ > 
name 


Parameters 


,BLOCK=N 
ee on 
Lyes 
.NCP=NO 
ans ro 
YES 
be (S-work_registe ee 


L supv-no—! 
» DIAG=N 
=— — 
~Lyes 


»—(positional_ buffer) > 


Function Specifies the register containing the address of the buffer to which the 
new buffer is to be chained. 


Format Register notation. 
Default None. 
Remarks Register 1 is not allowed. 


This value is not necessarily a pointer to the beginning of a PIU, but is a 
pointer to the actual buffer to which the new buffer should be chained. 


>—(chain_buffer) ,—_£—______ 


Function Specifies the register containing the address of the buffer to be chained. 
Format Register notation. 
Default None. 
Remarks Register 1 is not allowed. 
lf BLOCK=NO, this chained buffer must be a single buffer. 
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» BLOCK=N 
, BLOCK= 0 
— 
Function Specifies whether the new buffer is a single buffer or a buffer chain that 
is to be chained to the end of an existing chain. 


BLOCK=YES specifies that the new buffer is to be chained at the end of 
an existing chain. BLOCK=NO specifies that a single buffer is to be 
chained following a user-specified buffer in the existing chain. The user- 
specified buffer can be at any position. 


Format YES or-‘NO. 
Default NO. 


»NCP=NO 
prose = 
| Les 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES indicates that inline code is generated. 
NCP=NO indicates that an SVC is generated. 


Format YES or NO. 


Default NO. 
Remarks If NCP=YES, user-written code must be running in storage protection 
key 0. 


‘sie SS ork yegiste =| 


Function Specifies work registers, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 


Default None. 


L supv-no— 


Function Specifies that the issuer is running in level 5. 
Format NO. 


Default None. 
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» DIAG=NO 
, DIAG=-——-NO 
= 


Function Specifies whether the buffer address and location will be logged in the 
ABN diagnostic area if an abend occurs. 


Format YES or NO 
Default NO 


Remarks If YES is specified, the assembly must include dsect XCXTABN. If 
NCP=NO is specified, DIAG=YES is ignored. 
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CHAP—Change the Dispatching Priority of a Task 


Syntax 


cae SP Wea 
name 


Parameters 


The CHAP macro changes the dispatching priority of a specified task to 
appendage, immediate, productive, or nonproductive and replaces the task address 
in a specified queue control block (QCB). 


If the task is not in the pending state when the CHAP macro is issued, its QCB is 
flagged so that the subsequent activation of the task is appropriately scheduled. If 
the task is in the pending state, its QCB is flagged and the QCB of the task is 
removed from its current dispatching queue and put on the appropriate dispatching 
queue. 


Register 0 is not allowed for register parameters. 


Lgcbsaddress 
1 Required if SUPV=YES. 


LL TASK= label_———| 
 Leregister} 
, SUPV=NO 
—s =e 
Les 


Len wddressales 


1 Required if SUPV=YES. 


Function Specifies the address of the input or the pseudo-input QCB governing 
the task whose priority is to be changed. 


Format Register or label notation. 


Default If SUPV=YES, there is no default. If SUPV=NO, the QCB that activated 
the issuing task is the default. 
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Remarks Register 1 is not allowed. 


lf SUPV=YES, register 2 is standard and register 6 is not allowed. The 
contents of register 1 are destroyed. 


If a task is changing its own priority and the QCB address is omitted, the 
address of the QCB that started the task is used. 


Function Specifies the change to the dispatching priority as shown below: 


APPNDG Appendage 
IMMED Immediate 
PROD Productive 
NONPROD _— Nonproductive. 


Format APPNDG, IMMED, PROD, or NONPROD. 


Default The dispatching priority of the specified task remains unchanged. 


LL TASk= 1abei———] 
“TLE (pen ster) 


Function Specifies a replacement for the task address in the specified QCB. 
Format Register or label notation. 
Default None. 


Remarks Register 1 is not allowed. Register 2 is standard. If SUPV=YES, reg- 
ister 6 is not allowed and register 3 is standard. 


The task address can be any valid task in any valid QCB. 


, SUPV=NO 
=o ee 
Les 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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CHECKSS|—Check the Status of the NCP Buffer Pool 


Syntax 


The CHECKSSI macro checks the status of the NCP buffer pool to determine 
whether NCP is in slowdown, or whether the number of buffers remaining is below 


the CWALL value. 
The CHECKSSI macro generates inline code. 


Note: You must invoke the XXCXTXDB macro in the module that issues the 
CHECKSSI macro. 


Pe __7_CHECKSS ITY PE= CWALL »—-WKREG= (work_register )—@£§$——o—_—_——________"> 
name fale 


Parameters 


» INSTAT=SETZNC 
, INSTAT=——SETNC 
Ten 
SETZNC 


»>—TYP cant (eae 
SD 


Function Specifies whether the buffer availability check is for the in slowdown 
state (SD) or the below CWALL state (CWALL). 


Format SD or CWALL. 
Default None. 


>—WKREG= (work_register) ——_ £ ——@—-@_ —_\__— > 


Function Specifies a work register, the contents of which may be altered during 
| execution of the macro. 


Format Absolute register notation. 
Default None. 


Remarks Register 0 is not allowed. Specify an odd-numbered register only. 


» INSTAT=SETZNC 
» INSTAT=——SETNC 
Ten 
SETZNC 


Function Specifies whether the C latch, the Z latch, or both are to indicate the 
state of buffer availability. 
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Format SETZ, SETNC, or SETZNC. 
Default SETZNC. 


Remarks For SETZ or SETZNC, the Z latch is set to 1 if the state checked for 
exists. For SETNC or SETZNC, the C latch is set to 0 if the state 
checked for exists. 
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CHECKVR—Return VRB Fields Using the Virtual Route Control Block 


Syntax 


The CHECKVR macro uses the virtual route control block (VRB) address to return 
fields in the VRB. Any combination of outputs can be requested. 
Register 0 is not allowed for register parameters. 


Note: You must invoke the VRB DSECT macro XCXTVRB in the routine that 
issues the CHECKVR macro. 


oe oe ECKVR—VRB= (register) -——@£— ——H————____—_" 
name 


Parameters 


LL ERN=(register)— 
LL RERM=(register)— 
LL RERN=(register)— 
L RETCODE=(register)— 
LL osaF=(register)— 
L vpip=(register)— 


& LNID=(register)— 


>—VRB=(register) 


Function Specifies the VRB address of the virtual route to be checked. 
Format Absolute register notation. 
Default None. 


Remarks The register you specify for the VRB address must not be the same as 
the register specified for any other keyword. 


LS ERN- (pegisien— 


Function Specifies the explicit route number (ERN) associated with this VRB. 
Format Absolute register notation. 
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Default None. 
Remarks The register must be a byte register. 


The byte register you specify must not be the same as the register 
specified for LNID, RERM, RERN, or VRID. The register you specify 
must not be the same as any of the fullword registers specified for any 
other keyword. 


LU RERM= inegi ter) 


Function Specifies the reverse explicit route mask associated with this VRB. 
Format Absolute register notation. 

Default None. 

Remarks The register must be a fullword register. 


The register you specify must not be the same as the register specified 
for ERN, LNID, RERN, or VRID. The register specified must not be the 
same as any of the fullword registers specified on any of the other 
keywords of this macro. 


L_ RERN=(register)— 


Function Specifies the reverse ERN associated with this VRB. 
Format Absolute register notation. 
Default None. 


Remarks The register must be a byte register. The register you specify must not 
be the same as the register specified for ERN, LNID, or VRID. The 
register you specify must not be the same as any of the fullword regis- 
ters specified on any of the other keywords of this macro. 


ss RETCODE=(register)— 


Function Specifies the register to receive the 2-byte flag field of the VRB. Refer 
to the description of the VRB in NCP and EP Reference Summary and 
Data Areas, Volume 1, for bit definitions. 


Format Absolute register notation. 
Default None. 
Remarks The register must be a fullword register. 


The register you specify for RETCODE must not be the same as the 
register specified for any other keyword. 
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L osaF=(register)— 


Function Specifies the register to receive the subarea address of the other end of 
the virtual route. 


Format Absolute register notation. 
Default None. 
Remarks The register must be a fullword register. 


The register you specify for OSAF must not be the same as the register 
specified for any other keyword. 


L vpip=(register)— 


Function Specifies the virtual route identifier (VRID) associated with the required 
virtual route. 


Format Absolute register notation. 
Default None. 
Remarks The register you specify must be a byte register. 


The byte register you specify must not be the same as the register 
‘specified for ERN, LNID, or RERN. The register you specify must not 
be any of the fullword registers specified on any of the other keywords 
of this macro. 


= LNID= (register)— 


Function Specifies the local network identification (LNID) of the network in which 
the virtual route resides. 


Format Absolute register notation. 
Default None. 
Remarks The register must be a byte register. 


The register you specify must not be the same as the register specified 
for ERN, RERN or VRID. The register you specify must not be any of 
the fullword registers specified on any of the other keywords of this 
macro. 
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COMMIT—Commit Buffers 


The COMMIT macro determines whether enough buffers are available to schedule 
a poll and receive the resulting input. 


Note: This macro uses but does not destroy register 2 and, if NOTDONE is speci- 
fied, register 3. Register 6 must point to a save area. Register 0 is not allowed. 


Syntax 
aaa ES Niu ti ACB= EL aaa aaa aa 
name ~ Loepp= (register) 


, LEASE=NO 
C LEASE= — 
YES 
» RTN=NO 
C RTN= — 
~Lyes 
»POST=YES 
E POST= — 
YES 
» SUPV=NO 
, SUPV=——NO 
Te 


Parameters 


»>—ACB= (register )—_—_—_—__- - 


Function Specifies the address of the adapter control block (ACB) containing the 
buffer commitment request. 


Format Register notation. 
Default None. 
Remarks ACB and CBB may not be coded together. 
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>—CBB=(register) 


Function Specifies the address of the committed buffers block (CBB) containing 
the buffer commitment request. 


Format Register notation. 
Default None. 


Remarks ACB and CBB may not be coded together. 


» TYPE=CWALL 

» 1YPE=—-—COND 
CWALL 
PRECOMIT 


Function Specifies whether the commitment is conditional (COND) or uncondi- 
tional (CWALL) or whether a check on a commitment in progress 
(PRECOMIT) is being made. 


Format COND, CWALL, or PRECOMIT. 
Default CWALL. 


Function Specifies whether the C latch, the Z latch, or both are to indicate 
whether the request was satisfied. 


Format SETZ, SETNC, or SETZNC. 
Default SETZNC. 


Remarks For SETZ or SETZNC, the Z latch is set to 1 if the commitment is unsat- 
isfied or to O if satisfied. For SETNC or SETZNC, the C latch is set to 0 
if the commitment is unsatisfied or to 1 if satisfied. 


This keyword is valid only when SUPV=NO. 


» LEASE=NO 
os oa 
YES 
Function Specifies whether this macro should lease the buffers and chain them to 
the CBB when the commitment request is satisfied. 


Format YES or NO. 
Default NO. 
Remarks LEASE=YES is valid only when CBB is coded. 
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» RTN=NO 
=e — 
Lyes 
Function Specifies whether a routine address has been stored in the CBB. This 
routine will get control if the commitment request is posted and satisfied 


later. 
Format YES or NO. 
Default NO. 


Remarks RTN=YES is not valid if ACB is coded or if POST=NO. 


»POST=YES 
a 4 
~Lyes 
Function Specifies whether to put an unsatisfied commitment request on the 
appropriate ACHAIN of the commit request block (CRB). 


Format YES or NO. 
Default YES. 
Remarks This keyword is ignored if TYPE=PRECOMIT. 


» SUPV=NO 
= ae 
~Lyes 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer Is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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COMPARE—Compare Data in Two Storage Locations 


Syntax 


The COMPARE macro allows you to test data in two storage locations to determine 
whether the contents of the specified locations are equal or, if unequal, which is 
greater. After execution of the macro, the result register will contain X'00' if the 
data is equal or X'01' or X'02' if the data is unequal. For comparison, the 
storage contents are considered to be unsigned binary integers; however, storage 
fields containing the EBCDIC encoding of alphanumeric characters may also be 
compared, and the field with the greater alphabetical value (Z is greater than A) will 
have the greater value. The DSECT XCXTEQU is necessary for the proper expan- 
sion of the COMPARE macro. 


Do not use the COMPARE macro between portions of a connected IF macro (IF 
R1,EQ,R2,AND...) because the COMPARE macro includes an IF macro, and there- 
fore will assemble incorrectly. 


Register 0 is not allowed for register parameters. 


COMPARE ELD1=(register) ,—FIELD2=(register) ,—COUNT=(high_order_byte_register) ,——————> 


name 


»>—WORKR= (odd_register)——_—_____—————_—_—_—— — ——————— — — 4 


Parameters 


»>—FIELD1=(register) ,——— —____H]_> 


Function Specifies the register that contains a pointer to the beginning of the first 
item for comparison. 


Format Absolute register notation. 
Default None. 
Remarks A full register is required. 


Contents of this register are changed by the macro. 


el E2= (regs en) SS Se ee 


Function Specifies the register that contains a pointer to the beginning of the 
second item for comparison. 


Format Absolute register notation. 
Default None. 
Remarks A full register is required. 


Contents of this register are changed by the macro. 
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>—COUNT=(high_order_byte_register) ,—@-—-@ —@ ——_—H_—_— 


Function Specifies the register that contains the number of bytes to be compared 
(the number of bytes in each field). After the macro is executed, this 
register contains the result of the comparison, as shown in the following 
list: 


e X'00' if the field contents for comparison are equal 


e X'O1' if the contents of FIELD1 are numerically less than the con- 
tents of FIELD2 


e X'02' if the contents of FIELD2 are numerically less than the con- 
tents of FIELD1. 


Format Absolute register notation with high-order byte specification. (You must 
include 0.) 


Default None. 
Remarks The high-order byte of an odd-numbered register is required. 
The maximum field length is 255. 


Overlapping fields are handled normally. 


>—WORKR= (odd_register) -——___________________--»« 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Absolute register notation. 
Default None. 
Remarks An odd-numbered full register is required. 


The work register must not be the same as the field or count register. 
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CONVRT—Convert an Explicit Route Mask or Number 


The CONVRT macro generates inline code. It converts an explicit route mask to 
an explicit route number (ERN) or an ERN to an explicit route mask. For example: 


e B'10000000 00000000' converts to X'00'. 
B'01000000 00000000' converts to X'01'. 
B'00100000 00000000' converts to X'02'. 
X'00' converts to B'10000000 00000000'. 
X'01' converts to B'01000000 00000000'. 
X'02' converts to B'00100000 00000000'. 


The left-most bit set to 1 is the only one considered by the macro. No conversion 
is done on a mask of all zeros. If you code (odd register,H), an ERN greater than 
15 is converted to a mask of all zeros. If you code (byte register,B), an ERN 
greater than 7 is converted to a mask of all zeros. 


Register 0 is not allowed for register parameters. 


Syntax 

>> —CONVRT—T0=7—ERN- 7, —MASK=7— (odd_register ,H ee ee 
name ~Liwask— ie sae ao (byte_register) 

Parameters 


>—T0= re 
Laas 


Function Specifies the direction of conversion. TO=ERN specifies mask-to-ERN 
conversion. TO=MASK specifies ERN-to-mask conversion. 


Format  ERN or MASK. 
Default None. 


Remarks If TO=MASK, the ERN must be in byte 0 of the register specified by the 
ERN keyword. 


>—MASK= (odd_register ,H)-——. 
Tethyee. penister: B) 


Function Specifies the register that contains the mask value or specifies the reg- 
ister in which the mask value is to be returned. Use the 
(odd register,H) keyword if you are converting an ERN greater than 7, 
because you will require a halfword register. Use the 
(byte register,B) keyword if you are converting an ERN of 7 or less, 
because you will require only a byte register. 


Format Absolute or label register notation. 


Default None. 


104 NCP, SSP Customization Reference LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” CONVRT 
Licensed Materials — Property of IBM 


Remarks If TO=ERN and the mask register contains 0, no conversion is made. 


If TO=MASK and MASK=(odd register,H), a mask value of 0 is 
returned if the ERN is greater than 15. 


If TO=MASK and MASK=(byte register,B) a mask value of 0 is 
returned if the ERN is greater than 7. 


If TO=ERN, and the mask register does not contain 0, the mask register 
elements are changed by the CONVRT macro. If TO=ERN and the 
mask register contains 0, no conversion is made. 


>—ERN=(byte_register)-- —@ $$$ ___________{_  _ > 


Function Specifies the byte register that contains the ERN or in which the ERN is 
to be returned. 


Format Absolute or label register notation. 
Default None. 
Remarks The byte register specified cannot be a byte of the MASK register. 


lf TO=ERN and the MASK register contains 0, the ERN register is not 
modified. 


lf TO=MASK, the ERN must be in a high byte register (byte 0). 


If TO=MASK, the ERN register contents are changed by the CONVRT 
macro, with the exception that the byte register specified cannot be a 
byte of the mask register. 
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COPYBCU—Copy the Block Control Unit Work Area 


Syntax 


The COPYBCU macro causes the supervisor to copy the block control unit work 
area and the 14 bytes of basic transmission unit (BTU) control information from one 
buffer into a second buffer. That is, it copies 26 bytes, beginning at a displacement 
of +20, into the original buffer. 


Register 0 is not allowed for register parameters. 


coat ee PYBCU—(old_buffer_address_register) ,—(new_buffer_address_register) ————_—_—________> 
name 


Parameters 


, SUPV=NO | 
, SUPV=——NO 
= 


»—(old_buffer_address_register) ,————_______—— 


Function Specifies the register containing the address of the buffer containing the 
BTU to be copied. 


Format Register format. 
Default None. 
Remarks Register 1 is not allowed. 


If SUPV=YES, register 6 is not allowed, and register 3 is standard. 


»>—(new_buffer_address_register)-———_—___$$?SS > 


Function Specifies the register containing the address of the buffer into which the 
BTU is to be copied. 


Format __ Register notation. 
Default None. 
Remarks Register 1 is not allowed. 


lf SUPV=YES, register 6 is not allowed, and register 4 is standard. 
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, SUPV=NO 
, SUPV=——NO 
ie 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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COPYPIU—Copy a PIU from One Buffer to Another 


If the LEASE keyword is coded NO, the COPYPIU macro copies a FIDO or FID1 
path information unit (PIU) from one buffer into another. The fields copied are: 


e Resource type field from the unit information block (UIB) 

e UIB status 

e Transmission header (TH) 

e Request/response header (RH) 

e Request/response unit (RU) if the RU keyword is specified. 


All the bytes to be copied must be in the buffer pointed to by the old buffer 
address. After the fields are copied, the new PIU buffer prefix offset field points to 
the beginning of the transmission header; the PIU prefix count field shows the 
length of the TH+RH+RU; and the TH count field shows the length of the RH+RU. 
The event control block (ECB) block control unit (BCU) status field is set to 0 if 
specified by the ECBINIT keyword. 


If the LEASE keyword is coded YES, the service routine supplies the new buffers 
necessary to make a copy. The old PIU may be more than one buffer and does 
not have to be in the buffer pool. Omit the RU keyword because the complete RU 
will be copied. 


When LEASE=YES, the COPYPIU macro overwrites the first buffer of the original 
PIU with a pointer to the new PIU. Fields in bytes 0 to 15 are overlaid. Bytes 16 
to 19 contain a pointer to the new PIU. 


Register 0 is not allowed for register parameters. 


Note: If LEASE=NO, the COPYPIU macro produces code that may alter the con- 
tents of register 1. 


Syntax 
eh U—(old_buffer_address) ,—(new_buffer_address )————__________________> 


name 
, SUPV=NO 
Ta 
» ECBINIT=NO 
Ts 
»RU=0 
a= LO 
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, LEASE=NO 
e LEASE= = 
YES 
L WORKR= ( paredeoisteroe! 


Parameters 


»—(old_buffer_address ) ,——— Oo 


Function Specifies the register containing the buffer from which the PIU is to be 
copied. 


Format Register notation. 
Default None. 
Remarks Register 3 is standard. 
Register 1 is not allowed. 
If SUPV=YES, register 6 is not allowed. 


Old and new buffers must not be specified by the same register. 
»>—(new_buffer_address )———_—?$?+___ cr 


Function Specifies the register containing the buffer into which the PIU is to be 
copied. : 


Format Register notation. 
Default None. 
Remarks Register 4 is standard. 
Register 1 is not allowed. 
lf SUPV=YES, register 6 is not allowed. 


Old and new buffers must not be specified by the same register. 


» SUPV=NO 
a at 
~Lyes 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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» ECBINIT=NO 
, ECBINIT=——N 
= 


Function 
Format 
Default: 


Remarks 


Specifies whether the contents of the ECB status field is to be set to 0. 
YES or NO 

NO, if LEASE=NO. 

lf LEASE=YES, omit this keyword. 


,RU=0 
Capa 


Function 


Format 


Default 


Remarks 


Specifies the number of bytes in the RU to be copied. 


n indicates the number of bytes (decimal) to be copied; (R(B)) is byte 
register notation indicating where the length value is located; and 0 indi- 
cates that the RU is not to be copied. 


O, if LEASE=NO. 
lf LEASE=YES, omit this keyword. 


Register 1 (byte 0) is the preferred register and the contents are 
destroyed if not specified. 


, LEASE=NO 
E LEAS ace 
YES 


Function 


Format 
Default 


Remarks 


Shows whether the necessary buffers are to be leased by the service 
routine, or if the new buffer is supplied by the user. 


YES or NO. 
NO. 


lf LEASE=YES and there are not enough buffers in the free buffer pool 
to make a copy, nothing is copied and the new buffer address is 0. If 
LEASE=NO, both the old and the new buffer addresses must be in the 
buffer pool. 


lf LEASE=NO, only one buffer is copied. 
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s WORKR= ( pork vedtaters) 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Registers 1, 2, 3, 4, 5, and 7 (up to a maximum of six registers) can be 
specified using register notation. Do not use equated values. 


Default None. 
Remarks Specifying WORKR=1, 3, 4, or 7 can save controller machine cycles. 
WORKR=2 or WORKRE5 is ignored. 
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CXTSVX—Build a Save Area Chain 


Syntax 


yp ee 
name 


Parameters 


The CXTSVX macro builds a save area chain. It provides the save area chain 
structure for registers saved by the ROUTINE macro. The CXTSVX macro also 
provides the save area for the return linkage to the instruction following the 
PERFORM macro in the PERFORM, ROUTINE, RETURN macro sequence. 


Code the CXTSVX macro in program level 4 supervisor routines to save storage by 
creating common save areas and then providing linkage to the program level 5 
background routines that use them. 


The level 4 dispatcher initially sets up register 6 in program level 5 to point to the 
first save area at CXTSV5. Register 6 must be maintained by any module using 
the PERFORM, ROUTINE, RETURN macro sequence, its counterpart macro 
sequence LINK, SAVE, RESTORE, and the CASENTRY RTRN=RESTORE macro. 
Register 6 is updated to point to the correct save area by these macros unless 
overridden. 


The save area chain structure built by the CXTSVX macro can also be used by the 
LINK, SAVE, RESTORE macro sequence. The save areas are in storage that has 
a storage-protection key of 1; they are accessible to user routines. 


See gl re ee ee ee we 
NA=n 
, SAN=CXTSV5 
<=. == ne 
, SAN=——-CXTSV5 
“te Sanenie 


L Wa=n— 


Function Specifies the number of save areas to be built in the save area chain. 
Format Decimal values 3 to 255. 
Default 7. 


Remarks The value nis not checked. A value of 3 or less will result in three save 
areas in the chain. 
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» SAN=CXTSV5 
oe — 
"ea 
Function Provides an entry-point name for the save area chain. 


Format — Six valid characters. 
Default CXTSV5. 
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DACTVRIT—Deactivate an Internal Virtual Route 
The DACTVRIT macro generates a supervisor call instruction (SVC). It is used to 
deactivate an internal virtual route. 


Note that you can use this macro only in level 5. 


Warning: When a virtual route is deactivated, any sessions that are still active on 
the virtual route are deactivated. Therefore, users who are writing their own rou- 
tines are encouraged not to share virtual routes. (Refer to the description of the 


ACTVRIT macro.) 
Syntax 
>> —DACTVRIT—VRID= VCjIs(e)) eS ee 
name 
Parameters 


>—VRID= (register) ——— —_——_?$ is 


Function Specifies the virtual route identification number (VRID). The VRID has 
two values, the virtual route number (VRN) and the transmission priority 
field (TPF). The VRN value can be 0 to 7 and must be right-justified in 
byte O of the specified register. The TPF value can be 0 to 2 and must 
be right-justified in byte 1 of the specified register. 


Format Absolute register notation. 
Default None. 
Remarks Registers 0 and 1 are not allowed. 


No checking is done to see that the VRN and TPF values are valid. 
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DECOMMIT—Request That a Buffer Commitment Be Unassigned 


The DECOMMIT macro requests that a buffer commitment be unassigned. 


Register 0 is not allowed for register parameters. 


Syntax 
>>—name—DECOMMIT ACB= (regis Ce a a ae 
~ Lece= (register) 


L plu=(buffer)— 
» ALL=NO 
A 
, SUPV=NO 

: SU —— 


Parameters 


>—ACB=(register) 


Function Specifies the address of the adapter control block (ACB) containing the 
buffer commitment request to be decommitted. 


Format Register notation. 
Default None. 


Remarks ACB and CBB may not be coded together. 
>—CCB=(register ) 


Function Specifies the address of the committed buffers block (CBB) containing 
the buffer commitment request to be decommitted. 


Format __ Register notation. 
Default None. 


Remarks ACB and CBB may not be coded together. 
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L plu=(buffer)— 


Function Specifies the address of the input buffer chain. The number of buffers 
to be decommitted is equivalent to the number of buffers in the chain. 


Format Register notation. 
Default None. 


Remarks The receive buffer count is incremented by the number of buffers in the 
chain. 


» ALL=NO 
»ALL=——N 
= 


Function Specifies whether the complete current buffer commitment is to be unas- 


signed. 
Format YES or NO. 
Default NO. 


Remarks lf you specify YES, the next commitment size is calculated. 


You must specify YES if you omit the path information unit (PIU) 
keyword. 


, SUPV=NO 
, SUPV=——NO 
= 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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DEFMSK—Generate a Bit-Mask Symbol and a Conditional Branch 

Symbol 
The DEFMSK macro generates a bit-mask symbol and a conditional-branch 
symbol. The mask value shows the position of the bit in an 8- or 16-bit field, 
starting with 0. For the bit-mask symbol, the DEFMSK macro inserts bit 1 in the 
byte or halfword bit position that corresponds to the value of the mask. For 
example, the bit-mask symbol has a configuration of B'0001 0000' for a bit posi- 
tion of 3 and B'0000 0000 0010 0000' for a bit position of decimal 10. The 
conditional-branch symbol has the value of the specified mask. 


The DEFMSK macro generates both symbols when the mask is specified by 
decimal or IRNBITn notation, but generates only the bit-mask symbol when the 
mask is specified by hexadecimal (X'FE', for example) or binary notation 
(B'1111 1110', for example). 


The conditional-branch symbol is used to code the M field of the branch on bit (BB) 
instruction, the P field of the branch on bit extended (BBE) assembler extended 
mnemonic code, and in the IF and CASEIF macros. 


The bit-mask symbol is used to code the | field of the test register under mask 
(TRM) instruction and as a bit set/reset mask. 


Syntax 


pone EES 00s kee SS SS 


Parameters 


Function The DEFMSK macro generates the bit-mask symbol by concatenating 
the character M to the end of the specified name. The DEFMSK macro 
generates the conditional-branch symbol by concatenating the character 
B to the end of the specified name. 


Format Any symbol of 7 or fewer characters. 


Default None. 
—nas kk "4 


Function Specifies the value of the mask. 


Format Decimal values 0 through 15, IRNBITn where n can be any decimal 
value 0 to 15, binary notation, or hexadecimal notation. 


Default None. 


Remarks This keyword may be followed by up to 255 characters of comments, 


separated from the mask by a comma, and enclosed in single quotation 
marks. 
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DEQUE—Locate and Unchain the First Element in a Queue 


Syntax 


The DEQUE macro locates and unchains the first element, which can be the block 
control unit (BCU), the path information unit (PIU), or the queue control block 
(QCB), in a specified system queue and returns a pointer to the element. 


Register 0 is not allowed for register parameters. 


Note: Use the EXTRACT macro to detach any element, except the first, in a 
system queue. 


saa NE aa E—qcb_address ,—(register )- or 
name 


Parameters 


5 EMPTY=branch_address— 
»CONT=NO 
E a 
»NCP=NO 
ae 
LL WORKR= fvark:Fenister)= 


, SUPV=NO 
, SUPV=——-NO 
ca 


»>—qcb_address > 


Function Specifies the address of the QCB governing the queue from which the 
element is to be removed. 


Format Register or label notation. 


Default If SUPV=YES, there is no default. If SUPV=NO, the QCB that activated 
the issuing task is the default. 


Remarks Register 1 is not allowed. 


lf SUPV=YES, register 2 is standard, and register 6 is not allowed. 
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>—(register) ——_—____ > 


Function Specifies the register containing the address of the element to be 
located and dequeued. 


Format Register notation. 

Default None. 

Remarks Register 1 is not allowed. Register 3 is standard. 
If SUPV=YES, register 6 is not allowed. 


The contents of the register are set to 0 if the specified queue is empty. 


L EMPTY=b Sy re 


Function Specifies the address to get control if the queue is empty. 
Format Register or label notation. 
Default The instruction following the macro is given control. 
Remarks Register 1 is not allowed. 

If SUPV=YES, register 6 is not allowed. 


» CONT=NO 
» CONT=——-NO 
ie 


Function Specifies whether the queue is a contention queue (one that can be 
simultaneously manipulated by two or more interrupt levels). 


Format YES or NO. 
Default NO. 


»NCP=NO 
oo — 
Leyes 
Function Specifies whether the routine is to be generated inline. 
Format YES or NO. 
Default NO. 
Remarks If NCP=YES, you must specify WORKR. 


If NCP=YES, specify CONT=NO (either by specification or by default). 


If NCP=YES, the module must copy the DSECTs for the QCB and the 
event control block (ECB). 


If NCP=YES and SUPV=NO, you must specify the QCB address. 
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LL WORKR=(work_register)— | 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks The register specified must be an odd-numbered register. 


,SUPV=NO 
eae ae 
L yest 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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DETACHVR—Detach a Resource Control Block from a Virtual Route 


The DETACHVR macro terminates the association between a resource connection 
control block (RCB) and a virtual route. 


Register 0 is not allowed for register parameters. 


Syntax 
re — —_7DETACHYR~RCB= ddress——7—»—RETCOD E=(register )————___ > 
name enis ter) 
, SUPV=NO 
7 SUPV= “ses 
“Lies 
Parameters 


p>—RCB= address 
Lregister) 


Function Specifies the register containing the address of the RCB to be disassoci- 
ated from its virtual route. 


Format Register or the label or name of the RCB itself. 
Default None. 


Remarks The register specified for RCB must not be the same as the register 
specified for RETCODE. 


For best performance, you should specify register 2 when SUPV=YES. 


Neither register 1 nor register 6 is allowed. 


>—RETCODE=(regis ter) —__£§$—-@ oo] —> 


Function Specifies the register in which the return code is to be placed. The 
return codes are: 


X'0000' The operation was successful. 

X'0004' The RCB was not associated with a virtual route, so no 
action was taken. 

X'0006' The RCB was not associated with this virtual route. 

X'0008' The virtual route is inoperative. 


Format Register notation. 
Default None. 


Remarks The register you specify for RETCODE must not be the same as the 
register specified for RCB keyword. 


When SUPV=YES, choose either register 5 or 7 for best results. 


Do not specify register 6. 
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, SUPV=NO— 
, SUPV=——NO 
oe 
Function Specifies the level in which the issuer is running. SUPV=NO causes the 


macro to issue a supervisor request to level 4. SUP=YES causes the 
macro to link directly to the DETACHVR service routine. 


Format YES or NO. 
Default NO. 
Remarks If you code SUPV=NO, the macro becomes nonreentrant. 


If SUPV=YES, register 6 must point to an available save area. 
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DEVPARMS—Provide Device Information Fields 


The DEVPARMS macro provides device information fields so that you are not 
dependent on NCP control block structure. The macro generates inline code only; 
there is no service routine. 


Register 0 is not allowed for register parameters. 


Syntax 
aa ee Ee EVPARMS 
name 


Li ce= (register) — 

L asB= ipeaisten)= 

L cu- eqs 

L pveTYPE= inegister)=) 
L pvBFEAT= iregister)— 
L pveRID= (register. 
i LCBRID= fregiste)= 
. LCBDVBP= iregister)= 
a LGTTYPE= irenietenys) 
L cuBRsE= (register)— 


a CUBTYPE= (regis ter)— 
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Parameters 
Li cp- (pegisten\= 


Function Specifies the register containing the address of the line control block 
(LCB) to be referred to. 


Format Register notation. 
Default None. 


Remarks Specify one or more LCB, BSB, or CUB keywords. If you code BSB, 
use register 1, 2, 3, 4, 5, 6, or 7. 


L BsB=(register)— | 


Function Specifies the register containing the address of the boundary session 
control block (BSB) to be referred to. 


Format Register notation. 
Default None. 


Remarks Specify one or more LCB, BSB, or CUB keywords. If you code BSB, 
use register 1, 2, 3, 4, 5, 6, or 7. 


= CUB= iragisten)=| 


Function Specifies the register containing the address of the common physical 
unit block (CUB) to be referred to. 


Format Register notation. 
Default None. 


Remarks Specify one or more LCB, BSB, and CUB keywords. If you code BSB, 
use register 1, 2, 3, 4, 5, 6, or 7. 


L DVBTYPE= (register)—! 


Function Specifies the odd-numbered register to be updated with the contents of 
the DVBTYPE field from the DVB pointed to by the LCB. 


Format Register notation. 
Default None. 


Remarks The contents of the DVBTYPE field are returned in the low-order byte 
(byte 1) of the register. Use register 1, 3, 5, or 7. 


This keyword is valid only if you code the LCB keyword. 
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L DVBFEAT= (register)— 


Function Specifies the register returned with the contents of the DVBFEAT1 and 
DVBFEAT2 fields from the DVB pointed to by the LCB. 


Format Register notation. 
Default None. 


Remarks The contents of the DVBFEAT1 are returned in the high-order byte 
(byte 0) and the contents of DVBFEAT2 are returned in the low-order 
byte of the register. Use register 1, 2, 3, 4, 5, 6, or 7. 


This keyword is valid only if you code the LCB keyword. 


L_ pveRID=(register)— 


Function Specifies the register returned with the contents of the DVBRID field 
from the DVB pointed to by the LCB. 


Format Register notation. 
Default None. 


Remarks This keyword is valid only if you code the LCB keyword. Use register 1, 
2, 3, 4, 5, 6, or 7. | 


ES LCBRID= (register) 


Function Specifies the register returned with the contents of the LCBRID field 
from the referred-to LCB. 


Format Register notation. 
Default None. 


Remarks This keyword is valid only if you code the LCB keyword. Use register 1, 
2, 3, 4, 5, 6, or 7. 


L LcBDVBP=(register)— 


Function Specifies the register returned with the contents of the LCBDVBP field 
from the referred-to LCB. 


Format Register notation. 
Default None. 


Remarks This keyword is valid only if you code the LCB keyword. Use register 1, 
2,3, 4, 5, 6, or 7. 
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LGTTYPE=(regis ter)— | 


Function Specifies the odd-numbered register returned with the contents of the 
LGTTYPE field from the line group table (LGT). Use the LCB keyword 
to find the LGT. 


Format Register notation. 
Default None. 


Remarks The contents of the LGTTYPE field are returned in the low-order byte 
(byte 1) of the register. Use register 1, 3, 5, or 7. 


This keyword is valid only if you code the LCB keyword. 


L CUBRSE= (pegister)= 


Function Specifies the register returned with the contents of the CUBRSE field 
from the referred-to CUB. 


Format Register notation. 
Default None. 


Remarks This keyword is valid only if you code the CUB keyword. Use register 1, 
2, 3, 4, 5, 6, or 7. 


L cusTyPE= (register) 


Function Specifies the odd-numbered register returned with the contents of the 
CUBTYPE field from the referred-to CUB. 


Format Register notation. 
Default None. 


Remarks The contents of the CUBTYPE field are returned in the low-order byte 
(byte 1) of the register. Use register 1, 3, 5, or 7. 


This keyword is valid only if you code the CUB keyword. 
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DOWHILE and DOUNTIL—Begin a Loop Program Structure 


The DOWHILE and DOUNTIL macros provide the structure for repeated looping 
while or until specific conditions are met. They are used with the LEAVEDO and 
ENDO macros to form DO-loop program structures. The DOWHILE and DOUNTIL 
macros mark the beginning of the loop and the ENDO macro marks the end of the 
loop. 


The DOWHILE and DOUNTIL macros specify the condition for executing the DO 
loop. For DOWHILE, the DO loop is executed as long as the condition is true. The 
condition is evaluated at the beginning of the loop, so if the condition is not true 
when the loop is entered for the first time, the loop is not executed. For DOUNTIL, 
the DO loop is executed until the condition is true. The condition is evaluated at 
the end of the loop, so even if the condition is true when the loop is entered for the 
first time, the loop is executed at least once. 


The DOWHILE and DOUNTIL macros may form a multiple-step test through a 
logical connective keyword (with certain restrictions); however, DOWHILE and 
DOUNTIL macros cannot be mixed to build a test for a single DO loop. The last or 
only DOWHILE or DOUNTIL macro in a test designates the beginning of a DO loop 
function, and at least one is required for each DO loop. Loop processing is ended 
by branching to the next instruction following the ENDDO macro. The LEAVEDO 
macro can be used to end all loop processing without necessarily satisfying the 
specified test. The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. DO loops can be nested, and the separate loops 
may be a mixture of DOWHILE and DOUNTIL types. 


DOWHILE and DOUNTIL macros each have seven format types: 


e The no-operation format includes instructions for the first DOWHILE or 
DOUNTIL test within the loop. 


e The test CL, ZL format provides the same test as the corresponding IF macro 
format. 


e The branch-on-bit format provides the same test as the corresponding IF macro 
format. 


¢ The test-under-mask format provides the same test as the corresponding IF 
macro format. 


e The comparison format provides the same test as the corresponding IF macro 
format. 


e The DO-X-by-Y format decrements the variable X by Y (either a constant or the 
value in a register) each time the loop test is performed. The DO loop function 
is executed if the resulting value of X is greater than 0, and the loop is ended if 
X is 0 or negative. Note that the most efficient format is generated when Y is 
1. This format can occur only once per DO loop, and it is restricted to the first 

~DOWHILE or DOUNTIL in a test. 


e The branch-on-count format decrements the contents of a register by 1 until the 
result becomes 0. This format has a limited branch range because of the 
limited range of the BCT instruction it uses. The test is assembled at the end 
of the DO loop (at ENDDO) for maximum cycle efficiency. This format cannot 
be connected logically with another DOWHILE or DOUNTIL in a test; it must be 
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the only DOWHILE or DOUNTIL in a DO loop. However, it may be nested 
within other DO loops and may have other DO loops nested within it. 


Logical Connective Evaluation 


There are 4 logical connectives (or logical operators): AND, OR, (AND), and (OR). 
The different connectives indicate how the Boolean expression is parsed. The 
Boolean expression is fully parenthesized before execution. 


The following examples show how to place parentheses around the logical 
connectives (AND or OR) in multiple DOWHILE macros to perform tests containing 
two, three, or four parts in various logical groupings. You can code DOUNTIL 


macros the same way. 


In these examples, x, y, and z represent either logical connective (AND or OR); this 
convention lets you match the connectives in the coding samples to the 
connectives in the tests they perform. A, B, C, and D represent individual tests, 


such as: 


Coding Test 


R4(7),0ON Bit 7 of register 4 is on. 
R3(0),Z,0F Byte O of register 3 ANDed with mask X'OF' is zero. 
R5,LT,R7 The value in register 5 is less than the value in register 7. 


Note: Register 0 is not allowed for register parameters. 


Code a two-part test as follows: 


Code This... 
DOWHILE A,x 
DOWHILE B 


Code three-part tests as follows: 


Code This... 


DOWHILE A, (x) 
DOWHILE B,y 
DOWHILE C 


DOWHILE A,x 
DOWHILE B, (y) 
DOWHILE C 


DOWHILE A, (x) 


DOWHILE B, (y) 
DOWHILE C 
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For This Test 


AxB 


For This Test 


(Ax B) y C 


Ax (By C) 


Ax (By C) 
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Code four-part tests as follows: 


Code This... 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHTLE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 


DOWHILE 
DOWHILE 
DOWHILE 
DOWHILE 
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For This Test 


((A x B) y C) zD 


((A x B) y C) zD 


(Ax (By C)) zD 


(A x B) y (C z D) 


(Ax (By C)) zD 


(A x B) y (C z D) 


Ax (By (Cz D)) 


Ax (By (C z D)) 


Az ((B x C) y D) 


(Notice that you code the individual 
tests in a different order for this test.) 
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In the following example, the loop (the instructions between the DOWHILE macros 
and the ENDDO macro) is executed as long as: 


e Register 2 is not equal to register 6 and register 4 is not equal to register 6 
or 
e The Z condition latch is off. 


LOOP1 DOWHILE R2,NE,R6,H, (AND) 
DOWHILE R4,NE,R6,H,OR 
DOWHILE ZL,OFF 


ENDLOOP1 ENDDO 


In the following example, register 6 is decremented by 2 each time the loop is exe- 
cuted. The loop is executed until: 


e The value of register 6 is zero 
or 

e The 4 low-order bits of byte 0 of register 4 are zero and bit 7 of byte 0 of 
register 2 is on. 


In addition, there are two LEAVEDO macros coded in the loop. 


TWO EQU 2 

LOOP2 DOUNTIL (R6),BY, TWO, F,OR, LEAVEDO=2 
DOUNTIL R4(0),Z,OF,1, (AND) 
DOUNTIL R2(0,7),NZ,,H, 


ENDLOOP2 ENDDO 


No-Operation Format 


Syntax 
Po L. »NOP—,—, 
name DOWHI ie: 


Ls logical connective 


EP LEAV ad 
, LEAVEDO=n 
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Parameters 


> NOP, 


Function Specifies the no-operation format. 
Format NOP. 


Default None. 


is logical_connectt yell 


Function Specifies the Boolean logic operation used to connect this DOWHILE or 
DOUNTIL macro with the immediately following DOWHILE or DOUNTIL 
macros. The function of this keyword corresponds to the AND logical 
connective for the IF comparison format. See the description under 
“Logical Connective Evaluation” on page 128. 


Format AND, (AND). 


Default None. 
Banca 
, LEAVEDO=n 
Function Declares the number of LEAVEDOs that are executed within this partic- 
ular DO loop. 
Format Label notation. 
Default 0. 


Remarks The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. 


Test CL, ZL Format 


Syntax 
DOUNTIL CLT —: NZ 95 
name DOWHI ie Lop ON 
OFF 
Z 


, Logical_connective 


: LEAV sil 
» LEAVEDO=n 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 2. Macro Directory 131 


DOWHILE and DOUNTIL “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Parameters 


Ta 


Function Specifies that the C condition latch or the Z condition latch is to be 
tested. 


Format CLor ZL. 


Default None. 


Function Specifies the true condition (on, off, zero, or nonzero) for the specified 
latch. 


Format ON, OFF, Z, or NZ. 


Default None. 


,logical_connective 


Function Specifies the Boolean logic operation used to connect this DOWHILE or 
DOUNTIL macro with a following DOWHILE or DOUNTIL macro and the 
order in which keywords are paired when the Boolean expression is 
evaluated. There are two types of logical connectives, those with paren- 
theses and those without. See the description under “Logical 
Connective Evaluation” on page 128. 


Format AND, OR, (AND), or (OR). 


Default No logical connection is made between this DOWHILE or DOUNTIL 
macro and the following DOWHILE or DOUNTIL macro. 


——— 

, LEAVEDO=n 

Function Declares the number of LEAVEDOs that are executed within this partic- 
ular DO loop. 

Format Label notation. 


Default 0. 


Remarks The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. 
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Branch-on-Bit Format 


Syntax 
>> — 7 DONT I L register (bi 2 arenes We. NZ »—,—format 
name DOWHI ies Lepore ter (byte ,bit) ON 
OFF 
Z 


, Logical_connective 
x LEAV ae 
» LEAVEDO=n 


Parameters 


»— register (bit), 
register (byte,bit) 


Function Specifies the odd-numbered byte or halfword register containing the bit 
to be tested. If you specify a byte register, you can specify a bit from 0 
to 7, and you must specify the format keyword as B. If you specify a 
halfword register, you can specify a bit from 0 to 15, and you must 
specify the format keyword as H. 


Format Byte or halfword register notation. 


Default None. 


Function Specifies the true condition of the specified bit: on, off, zero, or 
nonzero. 


Format ON, OFF, Z, or NZ. 


Default None. 


>—fornat —— A 


Function Specifies whether the register is a byte (B) or halfword (H) register. 
Format Bor H. 


Default None. 
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a logical. connectives 


Function Specifies the Boolean logic operation used to connect this DOWHILE or 
DOUNTIL macro with a following DOWHILE or DOUNTIL macro and the 
order in which the keywords are paired when the Boolean expression is 
evaluated. There are two types of logical connectives, those with 
parentheses and those without. See the description under “Logical 
Connective Evaluation” on page 128. 


Format AND, OR, (AND), or (OR). 


Default No logical connection is made between this DOWHILE or DOUNTIL 
macro and the following DOWHILE or DOUNTIL macro. 


Resse 

, LEAVEDO=n 

Function Declares the number of LEAVEDOs that are executed within this partic- 
ular DO loop. 

Format Label notation. 

Default 0. 


Remarks The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. 


Test-under-Mask Format 


Syntax 
re ee I L—(compare_regis ter (byte) ) Ne »——mas k ,—I 
name DOWHILE 7] 


Ee Foaieatsconnectwe:: 
ees 
, LEAVEDO=n 
Parameters 
»>—(compare_register (byte) ) $$ 
Function Specifies the odd-numbered byte register, the contents of which are 
used in a logical AND comparison with the mask keyword. 


Format Byte register notation. 


Default None. 
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NZ—, 
7] 


Function Specifies the result of a logical AND comparison between the byte reg- 
ister contents and the mask keyword. Z is true if all the byte register 
bits corresponding to the mask bits are 0. NZ is true if one or more of 
the byte register bits corresponding to the mask bits are nonzero. 


Format Zor Nz. 


Default None. 
>——n0s kK, —___ 


Function Specifies an immediate byte value to be used in a logical AND compar- 
ison with the contents of the specified byte register. 


Format Label notation 


Default None. 
i] ee 


Function Specifies, in conjunction with Z or NZ, the test-under-mask format. 
Format |. 


Default None. 


Function Specifies the Boolean logic operation used to connect this DOWHILE or 
DOUNTIL macro with a following DOWHILE or DOUNTIL macro and the 
order in which keywords are paired when the Boolean expression is 
evaluated. There are two types of logical connectives, those with 
parentheses and those without. See the description under “Logical 
Connective Evaluation” on page 128. 


Format AND, OR, (AND), or (OR) 


Default No logical connection is made between this DOWHILE or DOUNTIL 
macro and the following DOWHILE or DOUNTIL macro. 


E LEAV —4 
» LEAVEDO=n 


Function Declares the number of LEAVEDOs that are executed within this partic- 
ular DO loop. 
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Format Label notation. 
Default 0. 


Remarks The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. | 


Comparison Format 


Syntax 


me es an i, Le yword] ,—operator ,—keyword2 ,—fornat > 
name DOWHILE 


Parameters 


le. Logical_connecti ven 


BE LEAV 4 
, LEAVEDO=n 


>—keyword! <x > 


Function Specifies the first value for the comparison test. 
Format Byte, halfword, or fullword (20-bit) register notation. 


Default None. 


»—operator, 


Function Specifies the type of comparison to be made between keyword! and 
keyword2: greater than (GT), less than (LT), equal to (EQ), not equal to 
(NE), not greater than (NG), not less than (NL), greater than or equal to 
(GE), or less than or equal to (LE). 


Format GT, LT, EQ, NE, NG, NL, GE, or LE. 


Default None. 


»>—keyword2, 


Function Specifies the second value for the comparison test. 


Format Byte, halfword, or fullword (20-bit) register notation, or if the format 
keyword is specified as |, label notation. 


Default None. 
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>—fornat 


Function Specifies whether keyword1 and keyword2 are byte registers (B), 
halfword registers (H), or fullword (20-bit) registers (F). Code | to 
specify that keyword! is a byte register and keyword2 is a byte- 
immediate value. 


Format’ £B,H, F, orl. 


Default None. 


= iocieni connectives. 


Function Specifies the Boolean logic operation used to connect this DOWHILE or 
DOUNTIL macro with a following DOWHILE or DOUNTIL macro and the 
order in which keywords are paired when the Boolean expression is 
evaluated. There are two types of logical connectives, those with 
parentheses and those without. See the description under “Logical 
Connective Evaluation” on page 128. 


Format AND, OR, (AND), or (OR) 


Default No logical connection is made between this DOWHILE or DOUNTIL 
macro and the following DOWHILE or DOUNTIL macro. 


aaiinetell 

, LEAVEDO=n 

Function Declares the number of LEAVEDOs that are executed within this partic- 
ular DO loop. 

Format Label notation. 


Default 0. 


Remarks The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. 


DO-X-by-Y Format 


Syntax 
>>— ____DOUNTIL 7—~(registerx) »-—BY,—(registerY) ,—fornat——_—___—_—_——_——— 
name DOWHILE 


i. logical_connectt ies 


x FROM=m— 
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e 4 | 
, LEAVEDO=n 

Note: This format can occur only once per DO loop, and it is restricted to the first 
DOWHILE or DOUNTIL in a test. 


»>—(registerX) ,-_____——————————— > 


Function Specifies the register containing the variable X. Each time the test is 
executed, the contents of this register are decremented by Y. 


Format Register notation. 


Default None. 
0 SE a EEE EEE EE ee 


Function Specifies the DO-X-by-Y format. 
Format BY. 


Default None. 
(C0 s ee) SSS SSS SSS a ee 


Function Specifies Y, the value by which registerX is to be decremented each 
time the test is performed. 


Format Register or label notation. In label notation, the range is from 0 to 255 
for byte format and from 0 to 65 535 for halfword format. 


Default None. 


>—fornat— ——__ 


Function Specifies whether registerX and registerY are in byte (B), halfword 
(H), or fullword (F) format. It may also specify registerY as a byte- 
immediate value (I). 


Format’ B, H, F, or I. 


Default None. 


a logical connective! 


Function Specifies the Boolean logic operation used to connect this DOWHILE or 
DOUNTIL macro with a following DOWHILE or DOUNTIL macro and the 
order in which keywords are paired when the Boolean expression is 
evaluated. There are two types of logical connectives, those with 
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parentheses and those without. See the description under “Logical 
Connective Evaluation” on page 128. 


Format AND, OR, (AND), or (OR). 


Default None. 


= FROM=m—! 


Function Specifies the first value of X. This value is set into register 1 on entry to 
the DO loop. If this keyword is blank, register 1 is assumed to be preset 
to its first value and so is not initialized when the DO loop is entered. 


Format Blank or label notation. The range is from 0 to 255 for byte format, and 
from 0 to 65 535 for halfword format. 


Default None. 
C — 
, LEAVEDO=n 


Function Declares the number of LEAVEDOs that are executed within this partic- 
ular DO loop. 


Format Label notation. 
Default 0. 


Remarks The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. 


Branch-on-Count Format 


Syntax 
r>——_—-DOUNTIL7—register,—8¢T, 
name DOWHILE 


L fo eae 


$ 


L FROM=m— ee 
Harli 
, LEAVEDO=n 


Note: This format cannot be connected logically with another DOWHILE or 
DOUNTIL in a test; it must be the only DOWHILE or DOUNTIL in a DO loop. 
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»>—register 2000S 


Function Specifies the register to be decremented each time the test is per- 
formed. 


Format Byte or halfword register notation. 
Default None. 


Remarks Specify an odd-numbered register only. When you specify the low-order 
byte of a register using byte notation, the complete halfword register is 
decremented. 


>—BCT, $$ 


Function Specifies the branch-on-count format. 
Format BCT. 
Default None. 


x format— 


Function Specifies whether the register is in byte (B) or halfword (H) register 
notation. 


Format BorH. 
Default None. 


Remarks This keyword in this particular format must be used in the third, rather 
than the fourth keyword position; the latter is this keyword's position in 
other formats. 


ES FROM=m—! 


Function Specifies the first count. This value is set into the register on entry to 
the DO loop. If this keyword is blank, the register is assumed to be 
preset to its first value and is not initialized when the DO loop is 
entered. 


Format Blank or label notation. The range is from 0 to 255 for byte format, and 
from 0 to 65 535 for halfword format. 


Default None. 
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— 

» LEAVEDO=n 

Function Declares the number of LEAVEDOs executed within this DO loop. 
Format Label notation. 


Default 0. 


Remarks The use of LEAVEDO within a loop must be declared on the first 
DOWHILE or DOUNTIL macro. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 2. Macro Directory 141 


DTRACE “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


DTRACE—Add an Entry to the Dispatcher Trace Table 


The DTRACE macro produces linkage code to branch to the dispatcher trace 
routine and produces an entry in the dispatcher trace table containing the queue 
control block (QCB), the path information unit (PIU), and task entry point 
addresses. A time stamp and indicator (D for normal dispatch and B for 
pseudodispatch) are also put in the trace entry. 


This macro can be used only in level 5 because it does not disable the lower 
levels. TYPE=DISPATCH is not recommended except for the task dispatcher. 


Register 0 is not allowed for register parameters. 


Syntax 


aan a a (qcb_address_register) ,—(piu_address_register)-———____________________—_—> 
name 


» 1YPE=PSEUDO 
— a 
Ls EUDO 
LL WORKR= iioreregister y=! 


Parameters 


»>—(qcb_address_register) > 


Function Specifies the register containing the pointer to the QCB to be traced. 
Format Register notation. 


Default None. 
»—(piu_address_register )}————_ 


Function Specifies the register containing the pointer to the PIU to be traced. 
Format Register notation. 


Default None. 


, TYPE=PSEUDO 
7 ——— 
Lops EUDO 


Function Specifies the indicator byte of the trace entry. The indicator byte is D 
when TYPE=DISPATCH (normal dispatch) and B when TYPE=PSEUDO 
(pseudodispatch). 


Format DISPATCH or PSEUDO. 
Default PSEUDO. 
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ES WORKR= ( popesenicrer = 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 


Default No work registers. 
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ECB—Build an Event Control Block 


The ECB macro builds an event control block. 


Register 0 is not allowed for register parameters. 


144 NCP, SSP. Customization Reference LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of BM” ECBINIT 
Licensed Materials — Property of IBM 


ECBINIT—Initialize an Event Control Block 


The ECBINIT macro initializes the status bytes of a specified event control block 


(ECB). 
Syntax 
ee ee ee 

rane meas aureR 
, SUPV=NO 
= a 
Lys 

Parameters 


sam aS a a a Ia 
(register7—___-) 
» BUFFER 


Function Specifies the address of the ECB to be initialized. 


Format Register or label notation. 


Remarks If the ECB is not defined in storage but is part of a block control unit 
(BCU) or a path information unit (PIU), you must use register notation 
and specify BUFFER. The register must point to the beginning of the 
first buffer of the BCU or PIU. 


If you do not code BUFFER, ECBINIT sets 2 bytes to 0 beginning at 
offset 0 and 2 bytes to 0 beginning at offset 4 into the ECB specified by 
the ECB address. 


If you code BUFFER, ECBINIT sets 4 bytes to 0 beginning at offset 8 
and 2 bytes to 0 beginning at offset 12 into the BCU or PIU specified by 
the register. The ECB is located beginning at offset 8 into the BCU or 
PIU. 


Note: If you use label notation, register 6 must point to a save area 
that can be overwritten. 


» SUPV=NO 
, SUPV=——NO 
i 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 2. Macro Directory 145 


ELSE “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


ELSE—Begin an Else Condition Program Structure 


The ELSE macro is used with the IF, THEN, and ENDIF macros to form an 
IF-THEN-ELSE program structure. It precedes the instructions that are executed if 
the results of tests made by the IF macro are false. You do not need to code an 
ELSE macro following an IF if the IF macro will be immediately followed by an 
ENDIF macro. 


Syntax 
pcan a ELSE 
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ENDCASE—End a Case Program Structure 


The ENDCASE macro is used with the CASEIF, CASENTRY, CASEXIT, and CASE 
macros to form a case program structure. The ENDCASE macro establishes the 
end of the case routine started by a CASE macro. The return function specified in 
the CASENTRY macro (for example, a branch back to the corresponding 
CASEXIT) is carried out at this point. 


Syntax 
oe DCASE 
name 
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ENDDO—End a DOWHILE or DOUNTIL Program Structure 


The ENDDO macro is used with the DOWHILE, DOUNTIL, and LEAVEDO macros 
to form DO loop program structures. The ENDDO macro designates the end of a 
DO loop function, and one is required for each DO loop. 


Syntax 
a ee ee 


name 
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ENDIF—End an IF-THEN-ELSE Program Structure 


The ENDIF macro is used with the IF, THEN, and ELSE macros to form an 
IF-THEN-ELSE program structure. The ENDIF macro follows the instruction 
sequence that is associated with the ELSE macro; it is always required to end the 
IF-THEN-ELSE program structure. 


Syntax 
a F 
name 
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ENQUE—Attach an Element to a Queue 


The ENQUE macro attaches an element, which can be a block control unit (BCU), 
a path information unit (PIU), a queue control block (QCB), or an event control 
block (ECB), to the end of a specified system queue and, optionally, activates the 
queue so that the associated task is scheduled for execution. 


For additional information on how the ENQUE macro affects task states, see “Task 
Management” in NCP and EP Reference. 


Use the INSERT macro to add an element anywhere in a queue except the last 
position. 


Register 0 is not allowed for register parameters. 


Note: This macro writes to the current save area and assumes that this save area 
can be overwritten. 


Syntax 


oa Se a E—qcb_address ,—(elemen iengdress pects ter) -——— 
name 
»ACTV=YES 
— ate 
» CONT=NO 
E —— tad 


»NCP=NO 
“rs == 
Leyes 
L WORKR= vor reoister)— 


, SUPV=NO 
are a 
~Lyes 
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Parameters 


Cl 000 SS SS SS SSS SS SSS ee ee 


Function Specifies the address of the QCB governing the queue to which the 
element is to be enqueued. 


Format Register or label notation. 


Default If SUPV=YES, there is no default. If SUPV=NO, the address of the 
QCB that activated the task is the default. 


Remarks Register 1 is not allowed. 


lf SUPV=YES, register 2 is standard and register 6 is not allowed. 
»—(element_address_register)—-@§&————________—_> 


Function Specifies the register containing the address of the element to be 
enqueued. 


Format Register notation. 
Default None. 
Remarks Register 1 is not allowed. 
lf SUPV=YES, register 3 is standard and register 6 is not allowed. 


If SUPV=YES, the element can be either a QCB or an ECB and does 
not have to be in a buffer. 


If SUPV=NO and the element is not a QCB, the element must be in a 
buffer; otherwise, NCP will abend. 


»ACTV=YES 
»ACTV=——NO 
i 


Function Specifies whether a task is to be scheduled for execution. ACTV=YES 
specifies that the task is to be scheduled for execution, that is, put in the 
pending state if another task is already active or in the active state if 
another task is not active. ACTV=NO specifies that the task is not to be 
activated as a result of enqueuing the element, or that the element is to 
be enqueued to a system work queue. 


Format YES or NO. 
Default YES. 


» CONT=NO 
E CONT= — 
Les 


Function Specifies whether the queue is a contention queue (one that can be 
simultaneously manipulated by two or more interrupt levels). 
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Format YES or NO. 
Default NO. 


» PRI=NO 
, PRI=——n 
bs. 
YES | 


Function Specifies the priority of the element to be enqueued. PRI=NO specifies 
that the element is to be enqueued at the end of the system queue with 
priority 0. PRl=n may be any value from 0-15 and specifies a priority 
value. This means that the element is enqueued ahead of all elements 
on the queue with lower priority, but behind those elements with equal 
or higher priority. PRI=YES specifies that the enqueuing position is 
determined as in the rn option, but the priority value is found in the 


element. 
Format NO, orn, or YES. 
Default NO. 


Remarks The same function is carried out for 0 and NO. 


A QCB is always enqueued at the end of the queue (effective priority 0). 
Do not use priority enqueuing with a queue on which QCBs are 
enqueued. 


»NCP=NO 
= — 
Lyes 
Function Specifies whether the routine is to be generated inline. 
Format YES or NO. 
Default NO. 
Remarks If NCP=YES, you must specify WORKR. 
If NCP=YES, code CONT=NO or allow it to default to NO. 


lf NCP=YES, code PRI=NO or allow it to default to NO. 


If NCP=YES, the module must copy the DSECTs for QCB, ECB, HWE, 
and XDA. 


LL WORKR= ivork-renisten)— 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks You must specify an odd-numbered register. 
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, SUPV=N 
, SUPV= 
YES 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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EXCR—Build an Exception Response PIU 


The EXCR macro builds an exception (negative) response path information unit 
(PIU) from a given request PIU specified in register 3. Four bytes of sense data, 
supplied as parameters, are inserted into the request/response unit (RU) followed 
by the RU prefix, if present. The remainder of the PIU is discarded. If the PIU is a 
FIDO or FID1, and XPORT=YES is specified, the PIU is sent to the originator of the 
request, and the content of register 3 is set to 0. If the PIU is a FID2 or if 
XPORT=YES is not specified, the exception response is returned to the EXCR 
issuer to be sent to the originator of the request. 


Register 0 is not allowed for register parameters. 


The name of the failing module and the displacement of the EXCR macro are 
placed in the NCP buffer and are included in trace records. 


The EXCR macro applies to an unsegmented message or to only the first segment 
of a segmented message. Succeeding or last message segments are discarded 
when errors occur. The EXCR macro can be used in program level 5 only. 


If the request/response header (RH) of the request PIU indicates “no response 
required,” the PIU will be discarded. 


Syntax 
ee ee »——sense2 
name 


,XPORT=NO | 
— 
a SAVE= (regis oe 
,TYPE=1 | 
——— 
,REQUEST=NO 
,USER=NO 
—— 
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Parameters 


»>—sensel ,—______ 


Function Specifies 2 bytes of sense data to be included in the exception 
response. 


Format Symbolic representation of the 2 sense bytes as they appear in the 
XXCXTSNS DSECT, or halfword register notation. 


Default None. 
pes opi go ee ee 


Function Specifies 2 bytes of user sense data to be included in the exception 
response. 


Format Symbolic representation of the 2 sense bytes as they appear in the 
XXCXTSNS DSECT, or halfword register notation. 


Default None. 


»XPORT=NO 
= ed 
YES 


Function Specifies whether the FIDO or FID1 PIU is to be sent to the requestor. 
XPORT=YES specifies that the FIDO or FID1 PIU is to be sent to the 


requestor. 
Format YES or NO. 
Default NO. 


Remarks XPORT=YES is not allowed if TYPE=2. 


The PIU must contain a valid virtual route vector table index (VVTI) if 
XPORT=YES. 


Code XPORT=YES only for functions in the peripheral node. 


hee Rice 


Function Specifies the registers that are to be saved before invoking the subrou- 
tine. 


Format __ Register. 

Default No registers are saved. 

Remarks If TYPE=1, only registers 4, 5, and 7 may be saved. 
If TYPE=2, only registers 5 and 7 may be saved. 


If the registers used above are not saved, their contents will be lost. 
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, TYPE=1 
——— 
Function Identifies the PIU type. 


Format 1 for FIDO or FID1 PIU; 2 for FID2 PIU. 
Default 1. 


» REQUES T=NO 
— 1 
Les 
Function Specifies whether an exception request is to be built. 
Format YES or NO. 


Default NO. 
Remarks REQUEST=YES is not allowed if TYPE=2. 


»USER=NO 
— =a 
~Lyes 
Function Specifies the storage in which the macro is being used. USER=NO 


specifies that the macro is being used in NCP's storage (protection key 
0). USER=YES specifies the user's storage (protection key 1). 


Format YES or NO. 
Default NO. 
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EXTRACT—Detach an Element from a Queue 


The EXTRACT macro detaches an element, which can be a block control unit 
(BCU), a path information unit (PIU), or a queue control block (QCB), from any 
specified position (except the first) in a given system queue. 


Use the DEQUE macro to detach the first element in a system queue. 


Register 0 is not allowed for register parameters. 


Syntax 


a ace ercee »——(positional_element_address )———-______________—_—____—"> 
name 


ce lavinae rence vement andress)— 


a LAST=b danchsaddpess! 
, SUPV=NO 
, SUPV=——NO 
— 


Parameters 


»—qcb_address ee 


Function Specifies the address of the QCB governing the queue from which the 
element is to be extracted. 


Format __ Register or label notation. 


Default If SUPV=YES, there is no default. If SUPV=NO, the QCB that activated 
the issuing task is used. 


Remarks Register 1 is not allowed. 


lf SUPV=YES, register 2 is standard and register 6 is not allowed. 
»—(positional_element_address )—£ ——____$J$S > 


Function Specifies the register containing the address of the element that is 
immediately before the element to be extracted. 


Format Register notation. 
Default None. 
Remarks Register 1 is not allowed. 


If SUPV=YES, register 3 is standard and register 6 is not allowed. 
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L (axtracted element address)— 


Function Specifies a register to receive the address of the extracted element. 
Format Register notation. 


Default The address is returned in the register containing the positional element 
address. 


Remarks Register 1 is not allowed. Register 4 is standard. 
If SUPV=YES, register 6 is not allowed. 


L LAST=b Paneh address! 


Function Specifies the address to be given control if the positional element is the 
last element on the queue. 


Format Register or label notation. 
Default The instruction following the macro gets control. 
Remarks Register 1 is not allowed. 

If SUPV=YES, register 6 is not allowed. 


,SUPV=NO 
= =e | 
Les 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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FETRACE—Activate the Supervisor, Register, and Dispatcher Traces 


Syntax 


The FETRACE macro activates the supervisor, register, and dispatcher traces. 


can (pS (aaa ETRACE—SVCTRC= er ere 
name YES 


Parameters 


LE aurecs-—-No—— 
YES 

x DSPTRC= — 
Ly ES 


Pere Slee rs ee eee ee eee ee ee 
YES 


Function Specifies whether the supervisor trace is to be turned on. 
Format YES or NO. 

Default None. 

Remarks If you code SVCTRC=YES, you must code DSPTRC=YES. 


Lj aurecs-—-No—— 
YES 


Function Specifies whether all level 5 registers are to be traced in the supervisor 
trace entries. 


Format YES or NO. 
Default None. 


Le, DSPTRC= No—— 
YES 


Function Specifies whether the dispatcher trace is to be turned on. 
Format YES or NO. 
Default None. 


Remarks If you code SVCTRC=YES, you must code DSPTRC=YES. If you code 
DSPTRC=NO, you must code SVCTRC=NO. 
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FINDUACB—Find a User Adapter Control Block (UACB) 


Syntax 


om (eer (al NDUACB 
name 


Parameters 


The FINDUACB macro in your level 2 interrupt handler implements user line 
control. You can also use it in level 5. It returns a pointer to the user adapter 
control block (UACB) associated with the interrupting line or the pointes to any other 
specified UACB. It uses register 1 as a work register. 


, LINEID=(4) 
eos 


(rl 
| , LINEID= (register) 


Function Specifies the register containing the address of the line vector table 
(LNVT) entry for the line (line ID). 


Format Register notation. 


Default If you omit this keyword, the macro assumes that register 4 contains the 
pointer to the LNVT entry for the line ID, and the macro will return the 
UACB pointer in register 4. 


Remarks Register 1(0) is standard. 
Register 1 is modified by this macro. 


Register 0 is not allowed. 
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FVTABLE—Build a Function Vector Table 


The FVTABLE macro builds a list of tasks that can be associated with one or more 
programmed resources. This list is called a function vector table (FVT). Its name 
is specified with the resource at program generation time. 


Syntax 


ye ABLE a INL TE One! »—NOTIFY=label 
name 


L CHAIN=Label— 


-_ (¥ (index, Label 14] 


fe USRNPM=abe1— 


Parameters 


»>—INITIAL=label —_@£- —_—______________—_ —_———_——_—_—_ 


Function Specifies the name of the task that will be inserted into the queue 
control block (QCB) to initialize the resource at NCP initialization. This 
task will always have an index value of 1 in the FVT. 


Format Label notation. 


Default None. 
>—NOTIFY=laebe |_—_——_——— > 


Function Specifies the name of the task that will be inserted into the QCB by 
NCP whenever a condition exists that directly affects the resource. This 
task will always have an index value of 2 in the FVT. The task should 
take whatever action is required by SNA and any other action you desire 
within the constraints of SNA. 


Format Label notation. 


Default None. 


LL CHAINeZabe1— 


Function Chains the FVT to another FVT. Label is the name of the next FVT in 
the chain. 


Format Label notation. 


Default None. 
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~ (-¥ (index, label a2) 


Function Specifies user tasks. Each parameter value pair specifies an index and 
a user task label. Indexes must be in ascending, but not necessarily 
consecutive, order from 10 to 255. All tasks to be associated with a 
resource QCB must be included in the FVT specified with the resource 
or in a chained FVT. 


Format Absolute notation and label notation. 


Default None. 


L USRNPM=Labe7— 


Function Specifies the user's NetView* Performance Monitor (NPM) task. This 
task will always have an index value of 4 in the FVT. 


Format Label notation. 


Default None. 
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GALERT—Build a Generic Alert NMVT PIU 


The GALERT macro is used by IBM special products or user-written code to build 
the common fields of a generic alert network management vector transport (NMVT) 
path information unit (PIU). It allows IBM special products or user-written code to 
interface with NCP code to build the common generic alert NMVT fields without 
violating storage protection keys. The information that GALERT builds and stores 
in buffers provided by IBM special products or user-written code includes the fol- 
lowing: 


Transmission header (TH) 

Response/request header (RH) 

NMVT request/response unit (RU) header 

Generic alert length bytes and major vector code 

SNA address list subvector X'04' 

Product set ID subvector X'10' 

Product set ID subvector X'11', which is defined by user-written code 
Relative time subvector X'42'. 


Note: The product set ID subvector X'11' that has been defined by user-written 
code will appear in the common generic alert only if the PRODID keyword is coded 
on the GROUP definition statement. The length of the IBM special products or 
user-written code subvector X'11' should not exceed 80 bytes. 


You can use register 7 as an input register, but the contents may not be preserved. 
Register 6 must point to a valid save area. Register 0 is not allowed. 


On exit, register 1 contains one of the following return codes: 


X'0000' Macro executed successfully, and a common generic alert NMVT is 
built. 


X'0001' No SSCP owners found, and a common generic alert NMVT is not built. 


X'0002' Insufficient buffers, and a common generic alert NMVT is truncated. 


Syntax 


re SALERT—LINEP= (register) ,—STAP=(register) ,—BUFRP=(register )———__________LLL 
name 


ce SU ——] 
, SUPV=NO 
mati 
»NCP=NO 


Parameters 


»>—LINEP=(register) ,——@ — —@——_ qm 


Function Specifies a register that points to the line control block (LKB). 


Format Register notation. 
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Default None. 


Remarks The register you specify must not be the same as the register specified 
for any other keyword. Neither register 1 nor register 6 is allowed. 


»—STAP=(register) —______ > 


Function Specifies the register that points to the station control block (SCB). 
Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as the register specified 
for any other keyword. Neither register 1 nor register 6 is allowed. 


>—BUFRP= (register) -——_£§_o— > 


Function Specifies the register that points to a chain of buffers that will be the 
target for the generic alert items. 


Format Register notation. 
Default None. 


Remarks You must pass a sufficient number of buffers, based on NCP buffer size. 
The common generic alert fields total a length of 150 bytes excluding 
the length of the IBM special products or user-written code product iden- 
tification subvector. When the product identification subvector is 
included in the generic alert, the total length of the common generic alert 
fields is 150 bytes plus the length of the IBM special products or user- 
written code subvector X'11'. 


The register you specify must not be the same as the register specified 
for any other keyword. Neither register 1 nor register 6 is allowed. 


sd 
, SUPV=NO 
Function Specifies that the issuer is running in level 5. 


Format NO. 
Default NO. 
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—— 
»NCP=NO 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=NO specifies that the issuer is running in NCP 
storage protection key 1. SVC code is generated. 


Format NO. 
Default NO. 
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GETBYTE—Load a Register Byte from a Block Control Unit 


Syntax 


The GETBYTE macro loads a register byte with a data byte from a specified posi- 
tion in a block control unit (BCU). The position from which the byte is fetched is 
specified in one of two ways. The first way is to specify a displacement value in 
the DISP keyword. Using this displacement value, the supervisor calculates the 
appropriate byte in the appropriate buffer of the BCU and fetches the byte. The 
supervisor then increments the displacement value by 1 and saves it. The second 
way is to omit the DISP keyword. The supervisor uses the displacement saved 
from the previous GETBYTE macro to calculate the position of the data byte. The 
supervisor then increments the displacement value by 1 and saves it. 


Register 0 is not allowed for register parameters. 


pe 7 GETBYTE—(8 yte) ,—(bcu_address_register)—#£——WC——__—__— 
name 


Parameters 


L pIsP=displacement— 


i FuD=branch gddress= 


»>—(byte) a ee eae ea ee re ee ee) ee eee ee 


Function Specifies a register byte into which the data byte is to be loaded. 


Format Byte register notation. 


Default None. 


Remarks Register 1(1) is not allowed. Register 1(0) is standard. 
»>—(bcu_address_register )-—@ —. $——H ———H— > 


Function Specifies the register containing the address of the first byte of the first 
buffer of the BCU that contains the data byte to be fetched. 


Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. 
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L pIsP=displacement—! 


Function Specifies the displacement from the first data byte of the BCU to the 
position from which a data byte is to be fetched. 


Format Absolute or register notation. 
Default | Computed displacement is used. 


Remarks Register 1 is not allowed. 


= FDebranch address 


Function Specifies the address to be given control if either the specified or the 
computed displacement exceeds the total size of the BCU. 


Format Register or label notation. 


Default The issuing program tests register 1(1), bit O. If the tested bit is 0, the 
byte was not fetched successfully. 


Remarks Register 1 is not allowed. 
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GETCB—Get Associated Control Block 


Syntax 


pea GE ICE IND TRS Cenpue control _block) ,—OUTPTR=(output_control_block) »—GET=7 BSB 


name 


Parameters 


For NCP V7R1 or V7R1F and later versions, the GETCB macro returns a pointer to 
the requested control block when you provide a pointer to the associated control 
block. 


Do not specify the same register for more than one keyword. 


Register 0 is not allowed for register parameters. 


Note: You must invoke the following DSECT macros in the routine that issues the 
GETCB macro. 


When: You must invoke: 
GET=BSB XCXTBSB and XCXTBXI 
GET=BXI XCXTBSB 


BXI 


>—INPTR=(input_control_block) , 


Function Specifies the register containing the address of the input control block. 
Format Register notation. 

Default None. 

Remarks Register 6 is not allowed. 


lf GET=BSB Is specified, INPTR must point to a boundary session block 
extension (BXI). If GET=BXI is specified, INPTR must point to an 
LU-LU boundary session block (BSB). 


>—OUTPTR=(output_control_block) ,—@@- i ——_—_—__—> 


Function Specifies the register in which the address of the requested control 
block will be returned. 


Format Register notation. 
Default None. 
Remarks OUTPTR must be an odd-numbered register. 


lf GET=BSB is specified, the address of the requested LU-LU BSB will 
be returned in OUTPTR. If GET=BXI is specified, the address of the 
requested BXI will be returned in OUTPTR. 
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>—GET=——BSB 
Lex 


Function Specifies the type of control block that is to be returned. GET=BSB 
specifies that the input BXI pointer will be used to get the pointer to the 
associated LU-LU BSB. GET=BXI specifies that the input LU-LU BSB 
will be used to get the pointer to the associated BX]. 


Format BSB or BXl. 


Default None. 
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GETIME—Retrieve System Time 


The GETIME macro either loads a specified register with the number of seconds 
since midnight (in binary) or moves all or some segments of the 20-byte system 
time and date stamp to a specified location. 


Syntax 
pe GET IME BINARY »—(register) 
name ~ Lgtamp—l 


, OPT IONS= 
TIME 


aie ed ; 
STAMP! 


Parameters 


Function BINARY indicates that the interval timer is to be loaded into a specified 
register. STAMP indicates that the system time and date are to be 
moved to a specified location. 


Format BINARY or STAMP. 


Default None. 
b= (TCGIS (er) = ee ‘ 


Function Specifies a register into which the interval timer is to be loaded or points 
to a location to contain the time and date stamp. 


Format Register notation. 

Default None. 

Remarks If STAMP is specified, register 1 is not allowed. 
Register 1 is modified by the macro expansion. 


Register 0 is not allowed. 


Function Specifies which segments of the 20-byte system time and data stamp 
are required. JUL means yy.ddd, where yy is the last 2 digits of the 
year and ddd is the day of the year. 
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CAL means mm/dd/yy, where mm is the month of the year, dd is the 
day of the month, and yy is the last 2 digits of the year. The format may 
also be dd/mm/yy or yy/mm/dd depending on what was specified at 
NCP generation. 


TIME means hh.mm.ss, where hh is the hour, mm is the minute, and ss 
is the second. 


JUL,TIME, means yy.dd.hh.mm.ss. 

CAL,TIME means mm/dd/yy (dd/mm/yy, yy/mm/dd), hh.mm.ss. 
Format JUL; CAL; TIME; JUL,TIME; or CAL,TIME. 
Default The complete 20-byte time and date stamp is moved. 


Remarks If you specify BINARY, this keyword is ignored. 
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GETPARM—Get a Pointer to a Parameter List or Byte Parameter 
The GETPARM macro is used by block handling routines (BHRs) to get a pointer to 
a parameter list or a pointer to a byte parameter. 


Register 0 is not allowed for register parameters. 


Syntax 


yy el PARM—(qcb_address ) 
name 
, PARMREG= (1) 
: PARMREG= eel 


Parameters 


»—(qcb_address )—_______-__ 


Function Specifies the address of the queue control block (QCB) from which the 
current BHR task is being dispatched. 


Format Register notation. 


Default None. 
, PARMREG= (1) 
sors ree 
Function Specifies the register into which either the pointer to the parameter list 
or the byte parameter is to be placed. 
Format Register notation. 


Default Register 1. 


Remarks If a BHR has a byte parameter associated with it instead of a pointer to 
a parameter list, the byte parameter goes into the low-order byte of the 
register. 
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GETPT—Get a Block Handler Execution Point 


The GETPT macro is used by block handling routines (BHRs) to get a bit configura- 
tion that represents the point of execution (1, 2, or 3). The points of execution are 
as follows: 


Point 1 After a request for the device is received but before the line is available 
Point 2 After a request for the device is received and after the line is available 


Point 3 After an input operation ends and after the line is released for use with 
another station. 


Register 0 is not allowed for register parameters. 


Syntax 
ae ETPT—(qcb_address) 
name 


C PTREG=(1(1) eae 
,PTREG=(byte_register) 


Parameters 


»—(qcb_address ) 


Function Specifies the register that contains the address of the queue control 
block (QCB) from which the current BHR task is being dispatched. 


Format Register notation. 


Default None. 
Betas Lae 
,PTREG=(byte_register) 
Function Specifies the register byte into which the bit configuration representing 
the point of execution is to be placed. 
Format Byte register notation. 
Default 1(1). 


Remarks The bit configuration returned is as follows: 


Point 1 Ulisse eetex 
Point 2 tO eis wes 
Point 3 1 eee 
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GRPEND—Indicate the End of a Line Group in the Block Dump Table 


The GRPEND macro indicates the end of the description of one line group in the 
block dump table (BDT). It sets the last 8-byte BDT entry to 0. 


Syntax 
Pe pe END 
name 
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GRPENTRY—Define the First Entry in the Block Dump Table 
The GRPENTRY macro defines the first entry in the block dump table (BDT). 


sae RO a Lock_length 
name 


Pe: ACBNAME= Riser ich namey 


Parameters 
Lara! 


Function Referred to by the ORIGIN keyword of a following (and dependent) 
BLKENTRY macro. 


Format Label notation. 
Default None. 


Remarks The label (name) is the name given to a macro that describes a parent 
block that points to a dependent block. In the macro that describes the 
dependent block, the ORIGIN keyword must contain the label of the 
parent block macro to complete the chained relationship. 


»>—LENGTH=block_length— ——_ 


Function Specifies the user adapter control block (UACB) length in bytes. 
Format Decimal notation. 


Default None. 


LS ACBNAME= nisemacpcnamey = 


Function Specifies the UACB name (the same name that was specified in the 
UACB keyword of a LINE definition statement) to be printed in the for- 
matted dump. The ACB name can be up to 5 characters long. 


Format Label notation; character string from 1 to 5 bytes long. 
Default UACB. 


Remarks The name is truncated if it is longer than 5 characters. 
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iF—Test for a Condition 


The IF macro is used with the THEN, ELSE, and ENDIF macros to form an 
IF-THEN-ELSE program structure. The IF macro has four types of format: test CL, 
ZL; branch-on-bit; test-under-mask; and comparison. The IF macro tests for a 
specified condition and, if the test is true, passes control to the routine defined by 
the THEN macro or, if the test is false, passes control to the routine defined by the 
ELSE macro. The following sections describe how to code logical connectives for 
multiple-step tests and the four formats of the IF macro. 


Logical Connective Evaluation 
There are four logical connectives (or logical operators): AND, OR, (AND), and 
(OR). The different connectives indicate how the Boolean expression is parsed. 
The Boolean expression is fully parenthesized before execution. 


The following examples show how to place parentheses around the logical 
connectives (AND or OR) in multiple IF macros to perform tests containing two, 
three, or four parts in various logical groupings. 


In these examples, x, y, and z represent either logical connective (AND or OR); this 
convention lets you match the connectives in the coding samples to the 
connectives in the tests they perform. A, B, C, and D represent individual tests, 
such as: 


Coding Test 

R4(7),0N Bit 7 of register 4 is on. 

R3(Q),Z,0F Byte 0 of register 3 ANDed with mask X'OF' is zero. 
R5,LT,R7 The value in register 5 is less than the value in register 7. 


Note: Register 0 is not allowed for register parameters. 


Code a two-part test as follows: 


Code This... For This Test 
IF A,x AxB 
IF B 


Code three-part tests as follows: 


Code This... For This Test 
IF A, (x) (Ax B) y C 
IF Byy 

IF C 

IF A,x Ax (By C) 
IF B, (y) 

IF C 

IF A, (x) Ax (By C) 
IF B, (y) 

IF C 
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Code four-part tests as follows: 


Code This... For This Test 


IF A,x ((A x B) y C) zD 


IF A, (x) ((A x B) y C) z D 


(Ax (By C)) zD 


IF A,x (A x B) y (C z D) 


IF A, (x) (Ax (By C)) z D 


IF A, (x) (A x B) y (C z D) 


IF A,x Ax (By (Cz D)) 


IF A, (x) Ax (By (C z D)) 


IF B, (x) Az ((B x C) y D) 


IF D,z (Notice that you code the individual 
IF A tests in a different order for this test.) 
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In the following example, the program structure is executed as long as: 


¢ Register 2 is not equal to register 6 and register 4 is not equal to register 6 
or 
e The Z condition latch is off. 


IF IF R2,NE,R6,H, (AND) 
IF R4,NE,R6,H,OR 
IF ZL,OFF 


ENDIF1 ENDIF 


Test CL, ZL Format 


Syntax 
eed TS ae: i 
Z 


,logical_connective 


Parameters 


oi 


Function Specifies that the C condition latch or the Z condition latch is to be 
tested. 


Format CLor ZL. 


Default None. 


NZ —; 
ON 
OFF 
Z 


Function Specifies the true condition for the specified latch: on, off, zero, or 
nonzero. 


Format ON, OFF, Z, or NZ. 
Default None. 
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= logical Seonnech ive 


Function Specifies the Boolean logic operation used to connect this IF macro with 
a following IF macro and the order in which keywords are paired when 
the Boolean expression is evaluated. There are two types of logical 
connectives, those with parentheses and those without. See the 
description under “Logical Connective Evaluation” on page 176. 


Format AND, OR, (AND), or (OR) 


Default No logical connection is made between this IF macro and the following 
IF macro. 


Branch-on-Bit Format 


Syntax 
>> — IF register (bit)——— Z >—s——format 
name register (byte ,bit) ‘Ha 
F 
Z 


, Logical_connective 


Parameters 


»—register {bit}, 
register (byte ,bit) 


Function Specifies the odd-numbered byte or halfword register containing the bit 
to be tested. If you specify a byte register, you can specify a bit from 0 
to 7, and you must code B for the format keyword. If you specify a 
halfword register, you can specify a bit from 0 to 15, and you must code 
H for the format keyword. 


Format Byte or halfword register notation. 


Default None. 


NZ — 
ON 
OFF 
Z 


Function Specifies the true condition of the specified bit: on, off, zero, or 
nonzero. 


Format ON, OFF, Z or NZ. 


Default None. 
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>—fornat—_—_—_—_____________ 


Function Specifies whether the register is a byte (B) or halfword (H) register. 
Format Bor H. 


Default None. 


ES logical_connecti ve | : 


Function Specifies the Boolean logic operation used to connect this IF macro with 
a following IF macro and the order in which keywords are paired when 
the Boolean expression is evaluated. There are two types of logical 
connectives, those with parentheses and those without. See the 
description under “Logical Connective Evaluation” on page 176. 


Format AND, OR, (AND), or (OR) 


Default No logical connection is made between this IF macro and the following 
IF macro. 


Test-Under-Mask Format 


Syntax 


A (compare_register (byte) ) eel a »—mask,—I 
name 1 


Parameters 


be lopical connectives 


—=(comare-register (byte) ) 


Function Specifies the odd-numbered byte register, the contents of which are 
used in a logical AND comparison with the mask keyword. 


Format Byte register notation. 


Default None. 


NZ—, 
7 


Function Specifies the result of a logical AND comparison between the byte reg- 
ister contents and the mask keyword. Z is true if all the byte register 
bits corresponding to the mask bits are 0. NZ is true if one or more of 
the byte register bits corresponding to the mask bit are nonzero. 


Format Zor NZ. 


Default None. 
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>—nas k, ——_— 


Function Specifies an immediate byte value to be used in a logical AND compar- 
ison with the contents of the specified byte register. 


Format Label notation. 


Default None. 
a (anne en ane ee ee ee 


Function Specifies, with Z or NZ, the test under mask format. 
Format |. 


Default None. 


is lagen canncenve=. 


Function Specifies the Boolean logic operation used to connect this IF macro with 
a following IF macro and the order in which keywords are paired when 
the Boolean expression is evaluated. There are two types of logical 
connectives, those with parentheses and those without. See the 
description under “Logical Connective Evaluation” on page 176. 


Format AND, OR, (AND), or (OR) 


Default No logical connection is made between this IF macro and the following 
IF macro. 


Comparison Format 


Syntax 


sign (SIR i yword! ,—operator ,—keyword2 ,—fornat > 


name 


Parameters 


- lagicai connective] 


CO SS See 


Function Specifies the first value for the comparison test. 
Format Byte, halfword, or fullword (22-bit) register notation. 


Default None. 
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»>—operator, 


Function Specifies the type of comparison to be made between keyword1 and 
keyword2: greater than (GT), less than (LT), equal to (EQ), not equal to 
(NE), not greater than (NG), not less than (NL), greater than or equal to 
(GE), or less than or equal to (LE). 


Format GT, LT, EQ, NE, NG, NL, GE, or LE. 


Default None. 


»>—keyword2, 


Function Specifies the second value for the comparison test. 


Format Byte, halfword, or fullword (22-bit) register notation, or if the format 
keyword is specified as |, label notation. 


Default None. 
0 a SS SS SSS SSS er 


Function Specifies whether keyword! and keyword2 are byte registers (B), 
halfword registers (H), or fullword (22-bit) registers (F). Code | to 
specify that keyword! is a byte register and keyword2 is a byte imme- 
diate value. 


Format’ B, H, F, orl. 
Default None. 


Ee logical. connective 


Function Specifies the Boolean logic operation used to connect this IF macro with 
a following IF macro and the order in which keywords are paired when 
the Boolean expression is evaluated. There are two types of logical 
connectives, those with parentheses and those without. See the 
description under “Logical Connective Evaluation” on page 176. 


Format AND, OR, (AND), or (OR). 


Default No logical connection is made between this IF macro and the following 
IF macro. 
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INCRP—increment the Response Phrase in the BTU System Response 
Field 


The INCRP macro increments the response phase currently in the BTU system 
response field (BCUSRES). This macro can be used in program level 5 and 
requires that the BCU DSECT XXCXTBCU be present and addressability be estab- 
lished. 


Syntax 
ea ee 
name 
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INHIBIT—Inhibit Interrupts 


The INHIBIT macro loads a specified register with the appropriate masks and 
issues an output instruction for that register to inhibit certain interrupts at the speci- 
fied interrupt levels (1, 2, 3, or 4). 


Note: This macro can be executed by interrupt-level code only. 


pe—___ INHIBIT : ,—(register )——_—__- 
name level 
won 
, SUPV=YES 
ons 
Parameters 


level 
on 


Function Specifies the level or levels to be masked. 


Format Absolute notation. If more than one level is to be masked, the list of 
levels is enclosed in parentheses. 


Default The supervisor assumes that the register has been preloaded with the 
appropriate inhibit mask. 


>—(register) ————_——_ ii > 


Function Specifies a register that is to contain (or already contains) the mask. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 
Basile 
, SUPV=YES 
Function Specifies that the issuer is running in an interrupt level. 


Format YES. 
Default YES. 
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INSERT 


INSERT—Insert an Element into a System Queue 


The INSERT macro attaches an element, which can be a block control unit (BCU), 

a path information unit (PIU), or a queue control block (QCB), to a system queue in 
any specified position except the last. Use the ENQUE macro instruction to attach 

an element to the last position in a system queue. 


Syntax 


cau ERSTE laa ERT ( 
name ae 


Parameters 


Register 0 is not allowed for register parameters. 


positional_elemen t_address)7—»—( insertion_element )——£—_—_____ 
qcb_address) 


, FIRST=N 
, FIRST=—-—-NO 
YES 
,CONT=N 
— a 
L_ ves 
, SUPV=NO 
= a 
Leyes 


»—(positional_element_address )— @ —@-@@————O@£ MH" 


Function 


Format 
Default 
Remarks 


Specifies the register containing the address of the element that the 
given element is to be inserted after (FIRST=NO). 


Register notation. 

None. 

lf FIRST=NO, this keyword is required. 
Register 1 is not allowed. 


lf SUPV=YES, register 3 is standard and register 6 is not allowed. 


»—(qcb_address > 


Function 


Format 
Default 


Specifies the register containing the address of the QCB governing the 
queue in which a new element is to be inserted in the first position 
(FIRST=YES). 


Register or label notation. 


lf SUPV=YES and FIRST=YES, there is no default. If SUPV=NO and 
FIRST=YES, the QCB for the queue that activated the issuing task is 
used. 
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Remarks This keyword is required if FIRST=YES. 
Register 1 is not allowed. 


lf SUPV=YES, register 2 is standard and register 6 is not allowed. 
»>—(insertion_elenent )——————_—— 


Function Specifies the register containing the address of the element to be 
inserted into the queue. 


Format Register notation. 
Default None. 
Remarks Register 1 is not allowed. 


If SUPV=YES, register 4 is standard and register 6 is not allowed. 


» FIRST=NO 
= F <a 
YES 


Function Specifies whether the new element is to be inserted in the first position 
of the specified queue. 


Format YES or NO. 
Default NO. 


» CONT=NO 
= — 
Lyes 


Function Specifies whether the queue is a contention queue (one that can be 
simultaneously manipulated by two or more interrupt levels). 


Format YES or NO. 
Default NO. 


» SUPV=NO 
= =aeat 
Lys 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. This information is needed so that 
the proper type of supervisor macro can be issued. 


Format YES or NO. 
Default NO. 
Remarks If SUPV=NO is coded, an EXIT instruction is generated. 
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lIOHM—lIssue an Input/Output Halfword Instruction 


The IOHM macro issues an adapter input/output halfword (IOH) instruction for the 
communication scanner processor (CSP) and stores the pending command and 
parameter status area (PSA) modifiers (if specified) in the PSA. 


When an IOH command is issued, the high-order bit of the PSA command field is 
set to 1 to indicate that the command is pending. When a level 2 interrupt occurs, 
the bit is reset to 0. Commands that set the high-order bit themselves are treated 
as special cases. These include commands X'FO0' to X'F2' and X'F5'. 


For these X'Fx' commands, you must use the PENDBIT keyword to ensure that 
the high-order bit is not reset for these commands. For other commands, the 
PENDBIT keyword defaults to YES (pending bit can be used). 


See Principles of Operation for your controlier for more information about |OH com- 
mands. 


Register 0 is not allowed for register parameters. 


Syntax 


pe COnmaepenatng tS: <comone »—WKREG1=(work_register) ,—WKREG2=(work_register) —_———»> 
name 


L_ MoD=psa_mod t ers 

EP Leh EES 
»PREFIX=prefix_characters 
»SL=SL 

oars 
, PENDBIT=YES 

E TT 


Parameters 


>—COMMAND=pending_CSP_comnand ,———_ 


Function Specifies the pending command. 


Format Register or label notation or hexadecimal value. You cannot specify the 
HALT and HALT IMMEDIATE commands with register notation. 


Default None. 
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>—WKREG1=(work_register) 


Function Specifies the R1 register for OH macro call. 
Format Register notation. 
Default None. 


Remarks Must be an odd-numbered general register when SL=SL and any 
general register when SL=SLI. 


>—WKREG2=(work_register) 


Function Specifies the R2 register for IOH macro call. This can be any odd- 
numbered general register. 


Format Register notation. 


Default None. 


L mop=psa_modi fers 


Function Specifies a byte or initial control word (ICW) field to be changed by the 
CSP. If you code this keyword, the modifiers are stored in the PSA. 


Format Register or label notation. 

Default None. | 

Remarks Must have addressability to the AXB and the PSA. 

Mnotes MNOTE 12,'IOHM MACRO REQUIRES COMMAND, WKREG1 AND WKREG2. ' 
MNOTE 12,'IOHM MACRO REQUIRES &SL TO BE SL OR SLI.' 


» PREFIX=PSA | 
E PREF IX=prefix_charac a 


Function Specifies the prefix used when XCXTPSA was included. 
Format PSA or any 3 character prefix. 
Default PSA. 


»SL=SL : 
7 — 
Ls 
Function Specifies START LINE (SL) or START LINE INITIAL (SLI). 


Format SLor SLI. 
Default SL. 
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» PENDBIT=YES 
E PENDBIT= a 
Ly es 


Function Specifies whether the command pending bit can be used for the 
command that is about to be issued. 


Format YES or NO. 
Default YES. 
Remarks Commands X'FO' to X'F5' require PENDBIT=NO. 
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LA—Generate the Load Address Instruction 


The LA macro generates the LA instruction as a series of define storage (DS) and 
define constant (DC) assembler definitions. 


Syntax 
seal I a ter ,—A=label 
name 


Parameters 


Regs ee ee 


Function Specifies the register that is to contain the specified address. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 

»>—A=Labe 1—__--___________---TTTTT------"-—_¥« 

Function Specifies the label of the location whose address is to be loaded into the 
register. 


Format Label notation. 


Default None. 
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LASTUACB—No Longer Functional 


The LASTUACB macro is no longer functional. It has been replaced by function 
internal to the NCP/EP definition facility (NDF). If you have user-written code that 
uses the LASTUACB macro, it will not cause any errors. 
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LDM—Load a Series of Registers 


Syntax 


The LDM macro sequentially loads a specified series of registers, starting from a 
specified area of storage. All 22 bits of each affected register are loaded directly 
without any shifting, and storage is accessed in 4-byte increments. 


Register 0 is not allowed for register parameters. 


r— Ln (ft rst_register) ,—(last_register) ,—storage_address-——______»« 


name 


Parameters 


p>—(fi rst_register) yo 


Function Specifies the first register in a series to be loaded. 
Format Register notation. 


Default None. 
»>—(last_register) .—@£@ —— ——_—__—_—_—_—_- ; 


Function Specifies the last register in a series to be loaded. 
Format Register notation. 


Default None. 
»—s torage_address———__________ 


Function Specifies the storage location from which the first register is loaded. 


Format Label or pseudobase displacement; that is, in the format (displacement, 
base) notation. 


Default None. 
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LEASE—Allocate a Buffer, a Buffer Chain, or a Unit of Storage 


The LEASE macro has three forms: 


e Normal use, SUPV=YES 
e Normal use, SUPV=NO 
e Character service use. 


The normal-use forms of the LEASE macro allocate a buffer or buffer chain of 
storage to the requesting program and return the address of the buffer or buffer 
chain. Both the buffer counts and the buffer offsets are set to O in all buffers. 


The character service form of the LEASE macro does the following: 


e Allocates a unit of storage 
e Detects and services buffer threshold allocation crossovers 
e Builds a buffer chain. 


The character service form of the macro allocates only one buffer at a time. 


Register 0 is not allowed for register parameters. 


Note: This macro uses the current save area and assumes that this save area 
can be overwritten. 


Normal Use, SUPV=YES 


Syntax 


jan ee ae E—SUPV=YES ,—ECB= ecvcoddhes se 
name ( registery7———___) 
(BUFFER) 


» ENQUE=INSERT 
» POINTER=(register) 
, PPOINTR=(register) 
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, PRELEAS=NO 
a ome 
~Lyes 
, ENABLE3=YES 
ores ons 
Leyes 
eee | 


p>—SUPV=YES, 


Function SUPV=YES specifies that the issuer is running in an interrupt level. 
Format YES. 
Default None. 


Remark: You must use SUPV=YES when coding in program levels 3 or 4. 


»—ECB>—ecb_addres ss 
(registe a gar TSR FP 
(BUFFER) 


$ 


Function Specifies the address of the event control block (ECB) governing buffer 
allocation. 


Format Absolute register or label notation. 

Default None. 

Remarks Do not specify register 1. LEASE processing alters its contents. 
When SUPV=YES, register 3 is standard and register 6 is not allowed. 


If register points to a previously allocated buffer that contains the ECB, 
you must specify BUFFER. 


Function Specifies whether the lease request is unconditional, conditional, or 
limited by the communication wall. 


Format UC, COND, or CWALL. 
Default UC. 
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LEASE 


Remarks Unconditional requests (TYPE=UC) are satisfied if buffers are available 


in the buffer pool. No partial allocation is made for unconditional leases. 
If the number of buffers requested is not available, the lease is not satis- 
fied. 


Conditional requests (TYPE=COND) are satisfied if the system is not in 
slowdown. If the system is in slowdown, the lease is unsuccessful. If 
the system is not in slowdown, and there are not enough buffers to com- 
pletely satisfy the request without entering slowdown (the free buffer 
count is less than the slowdown entry threshold), a partial allocation of 
buffers is made. A partial allocation puts NCP into slowdown because 
one more buffer is used to send an enter slowdown message to the 
host. This puts the free buffer count to one below the slowdown entry 
threshold (into slowdown). A partial allocation of buffers is considered 
successful. 


A communication wall request (TYPE=CWALL) is not satisfied if the 
system is in the CWALL state. If the request will cause the system to 
pass the CWALL threshold, only the number of buffers required to pass 
the threshold is returned; otherwise, the request is satisfied. A partial 
allocation of buffers is considered successful. 


is COUNT=buffers— 


Function Specifies the total number of buffers required. 


Format 
Default 


Byte register, label, or absolute notation. 


The byte register 1(0) is used and is set to one. 


Remarks If the request is partially satisfied, the residual count will be in the byte 


register specified. 


Function Either specifies the address to be given control if the request is not sat- 
isfied, or specifies that the C latch or Z latch is to indicate whether the 
request is satisfied. 


Format 
Default 


Label notation, register notation, SETZNC, SETZ, or SETNC. 


The issuing program tests register 1(1), bit O or the register specified by 
the POINTER keyword. If nonzero, the request is satisfied. 
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Remarks Do not specify register 1. 


For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 

request is not satisfied or to 0 if the request is satisfied. For SETZNC or 
SETNC, the C latch is set to O if the request is not satisfied or to 1 if the 
request is satisfied. 


L ENQUE=INSERT— 


Function Specifies whether an unconditional request for buffers is to disable lower 
priority interrupt levels if the request cannot be satisfied at present. 


Format = INSERT. 
Default None. 


Remarks Use ENQUE=INSERT only when coding unconditional requests 
(TYPE=UC) in program level 4. 


is POINTER=(register)— 


Function Specifies a register to contain the address of the allocated buffer or 
buffer chain. 


Format Register notation. 


Default The issuing program loads the allocated buffer address from the ECB, 
offset by 8. 


L TPOINTR= iregisteni= 


Function Specifies a register to contain the address of the last buffer in the chain 
allocated. If only one buffer is allocated, the address is the same as the 
address returned in the register specified for POINTER. 


Format Register notation. 


Default The issuing program loads the allocated buffer address from the ECB, 
offset by 0. 


Remarks Use this parameter only when you code the POINTER parameter. 
TPOINTR is not valid when ECB=(register,BUFFER) is coded. 


» PRELEAS=NO 
E PRELEAS= =a 
Lys 


Function Specifies whether the lease routine is to use preleased buffers, if avail- 
able. 


Format YES or NO. 
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Default 


Remarks 


LEASE 


NO. 


Use this parameter only when a level 5 routine has preleased buffers 
specifically for the use of the supervisory routine. 


» ENABLE3=YES 
E ENABLE3= ee 
Ly ES 


Function 


Format 
Default 


Remarks 


Specifies whether level 3 interrupts are to be enabled at the completion 
of the lease. 


ENABLE3=YES allows both level 2 and level 3 interrupts to be enabled 
at the completion of the lease. ENABLES=NO allows a level 4 routine 
to inhibit level 3 interrupts and to issue a lease. Only level 2 interrupts 
are enabled at the completion of the LEASE when ENABLE3=NO is 
coded. 


YES or NO. 
YES. 
Use this parameter only when SUPV=YES. 


\ sade (Yo rk_regis ie 


Function 


Format 
Default 


Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Register notation. 
No work registers. 


Do not use register 6. 


Normal Use, SUPV=NO 


Syntax 


a oe E—SUPV=NO ,—ECB= en ee 
name (register 


LE (BUFFER) — 


, TYPE=UC 
aac a 
“Lie 


Ee COUNT=bu ers! 
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» ENQUE=YES 
: <a 
YES 


L_ pOINTER= (buffer)— 


>—SUPV=NO, 


Function SUPV=NO specifies that the issuer is running in level 5. 
Format NO. 
Default None. 


Remarks You must use SUPV=NO when coding in program level 5. 


>—EC ala ik aaa a aaa aaa 
(regis eee 
(BUFFER) 


3 


Function Specifies the address of the event control block (ECB) responsible for 
buffer allocation. 


Format Absolute register or label notation. 
Default None. 
Remarks Do not specify register 1. Its contents are altered by LEASE processing. 


If a register points to a previously allocated buffer that contains the ECB, 
specify BUFFER. 


» TYPE=UC 
» 1YPE= OND 
a 
Function Specifies whether the lease request is unconditional or conditional. 
Format UC or COND. 


Default UC. 


Remarks Unconditional requests (TYPE=UC) are satisfied if buffers are available 
in the buffer pool. Partial allocation is not made for unconditional 
leases. If the number of buffers requested is not available, the lease is 
not satisfied. 
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Use TYPE=UC for leases of a critical nature, such as those that could 
cause deadlock of NCP or associated resources; otherwise, use 
TYPE=COND. 


Conditional requests (TYPE=COND) are satisfied if the system is not in 
slowdown. If the system is in slowdown, the lease is unsuccessful. If 
the system is not in slowdown, and there are not enough buffers to com- 
pletely satisfy the request without entering slowdown (free buffer count 
is less than slowdown entry threshold), a partial allocation of buffers is 
made. A partial allocation puts NCP into slowdown because one more 
buffer is used to send an enter slowdown message to the host. This 
puts the free buffer count to one below the slowdown entry threshold 
(into slowdown). A partial allocation of buffers is considered successful. 


L cOUNT=buffers— 


Function Specifies the total number of buffers required. 
Format Byte register, label, or absolute notation. 
Default The byte register 1(0) is used and is set to one. 


Remarks lf the request is partially satisfied, the residual count is in the byte reg- 
ister specified. 


Function Either specifies the address to be given control if the request is not sat- 
isfied, or specifies that the C latch or Z latch is to indicate whether the 
request is satisfied. 


Format Label notation, register notation, SETZNC, SETZ, or SETNC. 


Default The issuing program tests register 1(1), bit 0 or the register specified by 
the POINTER keyword. If nonzero, the request is satisfied. 


Remarks Do not specify register 1. 


For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 

request is not satisfied or to 0 if the request is satisfied. For SETZNC or 
SETNG, the C latch is set to 0 if the request is not satisfied or to 1 if the 
request is satisfied. 


This parameter is ignored when SUPV=NO, if TYPE=UC and 
ENQUE=YES. 
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» ENQUE=YES 
a ENQU ae 
YES 


Function Specifies whether an unconditional request for buffers is to disable 
levels 4 and 5 if the request cannot be satisfied. 


Format YES or NO. 
Default YES. 


Remarks ENQUE=YES is not recommended. The preferable method of 
enqueuing a task until buffers are available is through the PRELEASE 
macro with POST=YES. This allows other tasks that do not require 
buffers to execute. See PRELEASE macro on page 270 for more infor- 
mation. 


This parameter is ignored when SUPV=NO and TYPE=COND. 


L poINTER= (buffer)— 


Function Specifies a register to contain the address of the allocated buffer or 
buffer chain. 


Format Register notation. 


Default The issuing program loads the allocated buffer address from the ECB, 
offset by 8. 


Character Service Use 


Syntax 
r——___, LEAS E—SUPV=CHARSERV ,—BUFFREG= (buf fer_address_register) ,—WORKREG= (work_register) —————»> 
name 


L coUNT=buffers— 


= EMPTY=branch_address_regis ter 
= OLDREG= (buffer_register)— 
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Parameters 


>—SUPV=CHARSERV , 


Function Specifies the character service form of the macro. This form allocates a 
unit of storage, detects and services buffer threshold allocation crosso- 
vers, and builds a buffer chain. The character service form allocates 
only one buffer at a time, and is only for leases issued in level 2. 


Format CHARSERV. 
Default None. 
Remarks This form of the LEASE macro generates inline code. 


Use SUPV=CHARSERV only for leases issued in level 2. Other use 
could cause programming errors. 


The lease is successful if the system is not in CWALL state. 


lf SUPV=CHARSERV is coded, dsect XCXTABN must be included in 
the assembly. 


»>—BUFFREG=(buffer_address_register) ,———_———_____—_—_————_—"—> 


Function Specifies a register in which the address of the allocated buffer is 
returned. 


Format Register notation. 
Default None. 
Remarks Register 1 is not allowed. 
BUFFREG must be an odd-numbered register. 


The address returned is the address of the first byte of the leased 
buffer. 


»>—WORKREG=(work_register )—— _____________—_—_—_—_—_——""__—_——_——____—_———— 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. This work register is used by the supervisor. 


Format Register notation. 

Default None. 

Remarks The contents of the specified register are not preserved by the macro. 
WORKREG must be an odd-numbered register. 


L couNT=buffers— 


Function Specifies the total number of buffers required. 


Format Byte register, label, or absolute notation. 
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Default The byte register 1(0) is used and is set to one. 


Remarks /f the request is partially satisfied, the residual count is in the byte reg- 
ister specified. 


Do not code both COUNT and OLDREG. 
= EMPTY=branch_address_registe eal 


Function Specifies the address to be given control if the buffer allocation is not 
made. 


Format Label or register notation. 
Default The next instruction after the macro expansion is given control. 
Remarks Register 1 is not allowed. 


If you do not code EMPTY, the C and Z latches will indicate whether the 
request is satisfied. The C latch is set to 1 if the request is satisfied or 
to 0 if the request is not satisfied. The Z latch is set to 0 if the request 
is satisfied or to 1 if the request is not satisfied. 


a OLDREG= (buf for! régister)— 


Function Specifies a register in which the address of the previously allocated 
buffer is returned. 


Format Register notation. 
Default The currently allocated buffer is not chained to any buffer chain. 


Remarks This keyword causes the LEASE macro to chain the newly allocated 
buffer to a previously allocated buffer. If the newly allocated buffer is 
the first in the chain being built for the line, then the OLDREG register is 
filled with zeros. 


Register 1 is not allowed. 
Do not code both COUNT and OLDREG. 
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LEAVEDO—Exit a DOWHILE or DOUNTIL Program Structure 


The LEAVEDO macro is used in conjunction with the DOWHILE, DOUNTIL and 
ENDDO macros to form DO loop program structures. LEAVEDO generates a 
branch to the location following the ENDDO macro for the current DO loop. Where 
DO loops are nested, LEAVEDO branches to the ENDDO for the current next level. 
The number of LEAVEDO macros that are used within a DO loop must be declared 
on the first DOWHILE or DOUNTIL macro of the test for the current DO loop. 


Syntax 
cee OG ae EDO 
name 
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LINK—Store a Return Address and Branch to a Specified Address 


Syntax 


The LINK macro stores a return address in the first word of the system save area 
pointed to by register 6 and transfers control using a branch and link register, 
branch and link, branch long, or a branch register command to the specified branch 
address. The routine receiving control must reside in storage that has the same 
storage protection key as the routine issuing the LINK macro instruction. 


Register 0 is not allowed for register parameters. 


| return_address_register) ,—branch_address_register ,—————_____________—_—> 
name 


Parameters 


»—(return_address_register) ,———____$_2?_$_£?__$$£$£_$£$_$$$_$_____________> 


Function Specifies the register containing the return address. 
Format Register notation. 


Default None. 
»—branch_address_register ,———________ 


Function Specifies the location to which control is to be transferred. 
Format Register or label notation. 


Default None. 


Function Specifies that the return address is inline, saved by the routine to which 
it is linked, or external. 


Format |, B, or E. 
Default’ E. 
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Remarks If you code |, the LINK macro generates a label following the branch 
register of a BLG instruction. A load address instruction sets the (return 
address register) keyword as the return address. 


If you code B, either a BALR or BAL instruction is generated, and the 
routine receiving control must save the return address with the SAVE 
macro. 


If you code E, the LINK macro generates a BLG instruction. No return 
address is set up. 
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LINKTGB—Associate a Data Link Control Block with a Transmission 
Group Control Block 


Syntax 


The LINKTGB macro is used to establish and terminate the association of a spe- 
cific data link control block (SCB, CAB, or FLB) with a specific transmission group 
control block (TGB). 


Register 0 is not allowed for register parameters. 


»e—) 7 LINKTGB—TGB_address ,—DLCB= (register) = —MODE-— —-ATTACR >» 
name DETACH 


Parameters 


» 1YPE=—— (CHANNEL, SNA3) 
(CHANNEL , SNA4) 
(FATLINK, SNA4) 


, ERROR=SETCNZ 
, ERROR=——SETC 
/bserenz 
SETNZ 
, ERREG= (1) 
igor 
Te ee oe 
, SUPV=NO 
-, SUPV=——NO 
— 


SSG SS Ee 


Function Either specifies the register containing the address of the TGB to which 
the data link control block is to be attached, or specifies the register 
containing the address of the TGB from which the data link control block 
is to be detached. 


Format Register notation. 


Default None. 
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Remarks If SUPV=NO Is coded, register 1 is not allowed. 


lf SUPV=YES is coded, register 2 is standard and register 6 is not 
allowed. 


The register specified must not be the same as that specified for DLCB, 
ERREG, or WORKR. 


»—DLCB= (register) ££ ——— 


Function Specifies the register containing the address of the station control block 
(SCB), channel adapter block (CAB), or multilink transmission group 
control block (FLB). 


Format Register notation. 
Default None. 
Remarks If SUPV=NO is coded, register 1 is not allowed. 


lf SUPV=YES is coded, register 3 is standard and register 6 is not 
allowed. 


The register specified must not be the same as that specified for the 
TGB address, ERREG, or WORKR. 


You must specify an SCB, CAB, or FLB; do not specify more than one. 


>—MODE=——ATTACH 
~Loerach 


Function Specifies whether to link the control block specified by the DLCB 
keyword to a TGB or to terminate the current link. 


Format ATTACH or DETACH. 


Default None. 


, TYPE=—— (CHANNEL, SNA3) 
(CHANNEL, SNA4) 
(FATLINK, SNA4) 
(SDLC, SNA3 


(SINGLINK, SNA4) 


Function Specifies the type of data link control associated with the TGB. It also 
specifies whether the adjoining subarea node is at SNA 3 level (SNA3) 
or at SNA 4.2 level (SNA4). 


Format (CHANNEL, SNA3), (CHANNEL, SNA4), (FATLINK, SNA4), or (SDLC, 
SNA3), or (SINGLINK, SNA4). 


Default None. 
Remarks This keyword is valid only when MODE=ATTACH is coded. 
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» ERROR=SETCNZ 

» ERROR=——SETC 
SETCNZ 
SETNZ 


Function Specifies whether the C latch, the Z latch, or both are to indicate 
whether the requested link can be made. The link will not be made if 
another data link control block is currently linked to the TGB. 


Format SETCNZ, SETC, or SETNZ. 
Default SETCNZ. 
Remarks This keyword is valid only when MODE=ATTACH is coded. 


The C latch is set to 1 if the link cannot be made or to 0 if the link can 
be made. The Z latch is set to 0 if the link cannot be made or to 1 if the 
link can be made. 


iocet ae 
, ERREG= (register) 
Function Specifies the error-return register that will indicate whether the 


requested link was made. The link will not be made if another data link 
control block is currently linked to the TGB. 


Format Register notation. 


Default 1. 
Remarks This keyword is valid only when MODE=ATTACH and SUPV=YES are 
coded. 


Register 1 is standard and register 6 is not allowed. 


The register specified must not be the same as that specified for the 
TGB address or for DLCB. 


The register is set to nonzero if the link cannot be made or to 0 if the 
link can be made. 


Leia ae rk_registe a! 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Registers 1, 2, 3, 4, 5, and 7 (up to a maximum of 4 registers) can be 
specified. 


Default No work register. 
Remarks This keyword is valid only when SUPV=YES is coded. 


The registers specified must not be the same as that specified for the 
TGB address or for DLCB. 
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, SUPV=NO 
— =a 
~Lyes 


Function Specifies the level in which the issuer is running. SUPV=NO indicates 
that it is being invoked from level 5. SUPV=YES indicates that the 
macro is to be invoked in an interrupt level. 


Format YES or NO. 


Default NO. 
Remarks When SUPV=YES, register 6 must point to a save area that can be 
overwritten. 
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MAINT—Supply Maintenance Identification and the Module Name in a 
Dump 


The MAINT macro supplies maintenance identification and the module name in a 
program dump. 


Syntax 
aes re 


ae 
ODNAME=modu le_name 
Parameters 
ie 
ODNAME=module_name 
Function Specifies the name of the module to be used as an identifier ina 
program dump. 


Format Label notation. 
Default Control section (CSECT) name. 
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MAINTCS—Generate Additional CSECTs 


The MAINTCS macro generates additional control sections (CSECTs) within a large 
module to allow the use of the branch instruction rather than the branch long 
instruction to branch to and from patch areas located at the end of CSECTs. 


Syntax 
INTC ECT=CSECT_name ,—MODNAME=routine_name ,—ID=pre fix_name—MW——_____L» 


name 
» LAST=NO 
, LAST=——-NO 
ms 


Parameters 


»>—MCSECT=CSECT_nane ,———— 


Function Specifies the name of the main CSECT module. It will be used as an 
identifier in a program dump. 


Format Label notation. 
Default NONE. 


»>—MODNAME=routine_namne ,—___— 


Function Specifies the name of the module. It will be used as an identifier in a 
program dump. 


Format Label notation. 
Default NONE. 


lel an SS SS er 


Function Specifies a two-character name, which is used as a prefix to a 1-digit or 
2-digit count that MAINTCS generates. MAINTCS uses the prefix and 
count to generate the new CSECT name. The new CSECT name is 
CX$ppcc, where pp is the prefix_name and cc is the count. 


Format Literal two-character string. 
Default NONE. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 2. Macro Directory 211 


MAINTCS “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


» LAST=NO 
ao et 
Les 
Function LAST=YES specifies that the last CSECT that was generated should be 
generated again. LAST=NO specifies that a new CSECT should be 


generated. 
Format YES or NO 
Default NO. 
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MOVE—Move Bytes from One Storage Location to Another (Inline) 


The MOVE macro transfers a specified number of bytes from one storage location 
to another. The function is executed inline. 


Register 0 is not allowed for register parameters. 


Syntax 

Pe OVE FROM (register) 10> (register) 7 COUNT= Label_notation——,—WORKR= (register )—_——»< 
name is soe src coe ueale - 

Parameters 


»>—FROM=(register) , 


Function Specifies the register containing the starting address of the storage area 
from which the data is to be transferred. 


Format Register notation. 
Default None. 
Remarks The register must be unique from those used on the other keywords. 


At the end of the operation, this register contains the sum of the starting 
address and the count. 


>—T0=(register),—______________ 


Function Specifies the register containing the starting address of the storage area 
into which the data is to be transferred. 


Format Register notation. 
Default None. 
Remarks The register must be unique from those used on the other keywords. 


At the end of the operation, this register contains the sum of the starting 
address and the count. 


»>—COUNT=—label_notation——, 
“pesis pee 


Function Specifies the number of bytes to be transferred. 
Format Register or label (immediate) notation. 


Default None. 
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Remarks if in register notation, the register must be unique from those used on 
the TO and FROM keywords. The register may overlap the WORKR 
register. The most efficient expansion results when the high order byte 
of WORKR is used, for example, COUNT=(register(0)). 


If in label notation, the immediate count, n, must be a value from 0 to 
255. The value 0 results in 256 bytes being transferred. 


>—WORKR= (register) 


Function Specifies an odd-numbered halfword work register, the contents of 
which may be altered during execution of the macro. 


Format Register notation. 


Default None. 


Remarks The register must be unique from those used on the TO and FROM 
keywords. This register may overlap the COUNT register. 


At the end of this operation, the high-order byte of this register contains 
the value 0, and the low-order byte contains the last character trans- 
ferred. 
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MOVECHAR—Copy Bytes between Storage and Buffer Chains 


The MOVECHAR macro enables you to copy bytes from contiguous storage into 
buffer chains, from buffer chains into contiguous storage, and from buffer chains 
into buffer chains. Buffers can be leased to build a buffer chain as data is moved 
into it. 


MOVECHAR makes no adjustment of buffer offset fields. It also does no checking 
for overlapping FROM and TO fields. Generally, if the fields overlap, the buffer 
counts will be wrong. The buffer data counts must be correct in all buffers before 
you invoke MOVECHAR. The MOVECHAR macro generates a PERFORM linkage 
to CXDSMOVE. 


If you are using the MOVECHAR macro from level 5, you can use a 2048-byte 
work area at location CXTMV5. If you using it in a interrupt level, you can use a 
64-byte work area at location CXTMVS. 

Registers 0 and 6 are not allowed. Registers used to pass keywords will be modi- 
fied. You must provide a save area that can be overwritten before calling the 
MOVECHAR macro. 


lf you do not specify LEASE=YES or if the LEASE fails, only the number of bytes 
that will fit in the available buffers will be moved. 


Syntax 


cae Ge cae FROM= (register) ,—T0=(register) ,—COUNT=(register) ,—————_____LL_c# 
name 


a5) | oo rr aan 
=(register) , LEASE= 0 
YES 

de cla 

» ENABLE3=YES 

, SUPV=NO 


Parameters 


>— FROM=(register) ,——_ 


Function Specifies the register that contains the pointer to the start of the string of 
bytes to be copied. 
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Format Absolute register notation. 
Default None. 


Remarks The pointer to the byte following the last byte copied is returned in this 
register. 


>—T0=(register) ,—_—_—____ > 


Function Specifies the register containing a pointer to the place to which data is 
to be copied. 


Format Absolute register notation. 
Default None. 


Remarks The register specified must not be the same as that specified for FROM 
or FROMBUF. 


The pointer to the byte following the last byte moved is returned in this 
register. 


>—COUNT=(register) A 


Function Specifies the register that contains a count of the number of bytes to be 
copied. 


Format Absolute register notation. 
Default None. 


Remarks The register specified must not be the same as that specified for FROM, 
FROMBUF, TO, or TOBUF. 


A value of 0 is returned in this register if all bytes are successfully 
copied. A count of the remaining bytes is returned if all bytes could not 
be moved. 


>—7_FROMBUF = (register), 
TOBUF=(register) , LEASE= — 
YES 


Function Specifies the register that points to the buffer containing the start of the 
string of bytes to be copied, or the buffer into which data is to be 
moved. 


LEASE specifies that buffers are to be leased if the string overruns 
buffer boundaries. 


Format Absolute register notation; YES or NO. 
Default None. 


Remarks The register specified for FROMBUF must not be the same as that 
specified for FROM. The register specified for TOBUF must not be the 
same as that specified for FROMBUF or TO. 
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MOVECHAR 


If you do not code the FROMBUF keyword, it indicates that the FROM 
string is in contiguous storage. If you do not code TOBUF, it indicates 
that the data string is to be moved to contiguous storage. 


You must code either the FROMBUF or the TOBUF keyword. 


The pointer to the buffer containing the end of the FROM string is 
returned in the FROMBUF register. The pointer to the buffer that con- 
tains the end of the data moved is returned in the TOBUF register. 


LEASE is valid only if you code the TOBUF keyword; it must be coded if 
you code TOBUF. 


If a LEASE fails before all data is copied, a residue count is returned. 


» DATCNT=N 
E DATCNT= a 
Ly ES 


Function 


Format 
Default 
Remarks 


Specifies whether the buffer data count is incremented. DATCNT=YES 
specifies that the buffer data count field is incremented for each byte 
moved into the buffer. DATCNT=NO specifies that the data count field 
is left unchanged. 


YES or NO. 
NO. 
If you code DATCNT=YES, you must code TOBUF. 


New leased buffers have data count set to 0. If DATCNT=NO, no 
change is made. If DATCNT=YES, the data count is incremented. 


lf a buffer has a nonzero data count and DATCNT=YES, the number of 
bytes moved into that buffer is added to the existing count. If 
DATCNT=NO, the buffer data count is not changed. 


» ENABLE3=YES 
E ENABLE3= “oo 
Ly ES 


Function Specifies whether level 3 interrupts are enabled at the completion of the 


Format 
Default 


LEASE. ENABLE3=YES allows both level 2 and level 3 interrupts to be 
enabled at completion of the LEASE. ENABLE3=NO allows a level 4 
routine to inhibit level 3 interrupts and issue a LEASE macro; only level 
2 interrupts are enabled at the completion of the LEASE. 


YES or NO. 
YES. 


Remarks This keyword is valid only when SUPV=YES. 
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, SUPV=NO 
E SUPV= = 
~Lyes 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in interrupt level. This information is needed by 
CXDSMOVE so that the proper type of supervisor macro can be issued. 


Format YES or NO. 
Default NO. | 
Remarks If you code SUPV=NO, an EXIT instruction is generated. 
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MVQUE—Move the Contents of One Queue to Another 


The MVQUE macro moves the entire contents of one queue to another queue. 

The moved queue contents can be moved ahead of or behind the receiving queue 
contents. SUPV=YES is the only valid usage of this macro. This function assumes 
that the first two adjacent fullwords of the sending and receiving queue control 
blocks (QCBs) are the head and tail pointers, respectively. The elements of the 
sending QCB must contain an event control block (ECB). Register 1 is destroyed if 
standard registers are used for the sending and receiving QCB addresses. 


Register 0 is not allowed for register parameters. 


Syntax 
|e E—(sending_qcb_address ) ,—(receiving_qcb_address )—£ ——H—_—_______——> 
name 


»MOVE=FIRST 
»MOVE=——FIRST 
Tae 
| eee Mees: | 
Raabe 
, SUPV=YES 


Parameters 


»—(sending_qcb_address) ,— > 


Function Specifies the register that contains the address of the QCB, the com- 
plete queue contents of which are to be moved. 


Format Register notation. 
Default None. 
Remarks Register 2 is standard. 


The sending QCB address register cannot be the same as the receiving 
QCB address register. Register 1 is not allowed. 


If the sending QCB is empty, no action is taken. 


The sending QCB's head and tail pointers are each set to 0. 
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»>—(receiving_qcb_address > 


Function Specifies the register that contains the address of the QCB, the queue 
of which is to receive the sending queue contents. 


Format Register notation. 
Default None. 
Remarks Register 3 is standard. 


The receiving QCB address register cannot be the same as the sending 
QCB address register. Register 1 is not allowed. 


»MOVE=FIRST 
= E= aa 
Last 


Function Specifies the order in which queue contents are to be queued. FIRST 
specifies that the sending queue contents are to be queued ahead of 
the receiving queue contents; LAST specifies queueing behind the 
receiving queue contents. 


Format FIRST OR LAST. 
Default FIRST. 


a a 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. Specifying such registers makes execution of 
the macro more efficient. 


Format Registers 1, 2, 3, 4, 5, and 7 (up to a maximum of 6 registers) can be 
specified. Equated values cannot be used. 


Default: No work registers. 
» SUPV=YES 
os 
Function Specifies that the issuer is running in an interrupt level. 


Format YES. 
Default YES. 
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NCHNG—Change Fields in a Programmed Resource Control Block 


The NCHNG macro changes fields in programmed resource control blocks. It gen- 
erates a parameter list and an SVC call to the NCHNG service routine. The macro 
uses register 1, so register 1 cannot be used to pass or receive information. If the 
information being passed requires less than a full register, the information must be 
right-justified in the register and the remainder of the register must be set to 0. 


lf the NCHNG requests are satisfied, register 1 will contain 0. If one or more of the 


requests cannot be satisfied, the low-order byte of register 1 will contain error bits 
identifying the errors: 


Bit 0 (X'80') Specified index was not found in a function vector table (FVT). 
Bit 1 (X'40') Request was not valid for the control block specified. 


Bit 2 (X'20') New session partner specified was already in session or no virtual 
route vector table index (VVTI) was specified when using extended 
network addressing (ENA). 


Bit 3 (X'10') Programmed resource logical unit block extension (NLX) specified 
was unavailable for a new session. 


Register 0 is not allowed for register parameters. 


Note: You must code the CNTLBLK keyword and at least one other keyword. 


Syntax 


eH LBLK= (register) 
name 


ess FORREQ=—-RESET—— 
SET 


L- COLLEN= vedi ster) 


L supy= No—— 
~Lyes 
L EVINDEX= nunber———| 
“treaister) 


L  pURGE=YES—! 


am PARTNER= NoNe————1 
“EE (pagister) 


L SNPOFF=(register)— 
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L  sNPON= (register | 
LL NOTIFY=CLEAR— 
LL USERCB= (register) 


s IMBET=—7—RES er 
SET 


L wti=(register)— 


Parameters 


>—CNTLBLK=(register) -—@@ S$ > 


Function Specifies the register containing the address of the programmed 
resource control block defining the resource being serviced. 


Format Register notation. 


Default None. 


& FORREQ=—7—-RES et 
SET 


Function Sets or resets the request for FORWARD notification during NetView 
Performance Monitor (NPM) processing. This keyword is valid only 
when the CTLBLK keyword specifies an NQE. 


Format SET or RESET 
Default None. 


L_ COLLEN=(register)— 


Function Specifies the register that contains the length of the resource record that 
contains NPM performance data. 


Format _ Register notation 


Default None. 
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ie SU Py-—-No—— 
YES 


Function Specifies the level in which the issuer is running. SUPV=NO indicates 
that it is invoked from level 5. SUPV=YES indicates that this macro is 
invoked in an interrupt level. 


Format YES or NO 


Default None. 


» FV INDEX=——numbe 
(register) 


Function Specifies an index to a new task pointer on the FVT for the resource. 
The task pointer is placed in the queue control block (QCB) for the 
resource, and NCP dispatches the new task the next time the QCB is 
activated. The FVTABLE values of both the previous and the new tasks 
are saved in the programmed resource control block. 


Format Absolute or register notation. 


Default None. 


L purce=YEs— 


Function Purges all elements currently queued to the control block. 
Format YES. 


Default None. 


5 PARTNER= NoNE————] 
e(pegisier) 


Function Replaces the session-partner field in the given session control block with 
O if NONE is specified or with the element address in the specified reg- 
ister. This keyword is valid only when the CNTLBLK keyword specifies 
an NLX. Use NONE to clear an NLX at the end of a session and make 
it available for future use. Any path information unit (PIU) whose desti- 
nation address field (DAF) matches the element address in the pro- 
grammed resource logical unit block (NLB) and whose origin address 
field (OAF) matches the session partner's element address field 
(nonzero) in the NLX will be enqueued to the NLX rather than to the 
NLB. 


Format NONE or register notation. 


Default None. 
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L sNPOFF=(register)— 


Function Specifies the register whose low-order byte contains a session control 
block (SNP) mask that NCP uses to turn off a corresponding bit in the 
SNPMASK field of the specified programmed resource control block. 
This shows that the SSCP identified by the SNP mask is no longer an 
owner of the resource. This keyword is valid only if the CNTLBLK 
keyword specifies a programmed resource virtual line block (VLB) or a 
programmed resource physical unit block (NPB) and if the SNPON 
keyword is not coded. 


Format Register notation. 


Default None. 


LL SNPON= (register)— 


Function Specifies the register whose low-order byte contains an SNP mask that 
NCP uses to turn on a corresponding bit in the SNPMASK field of the 
specified programmed resource control block. This shows that the 
SSCP identified by the SNP mask is now an owner of the resource. 
This keyword is valid only if the CNTLBLK keyword specifies a VLB or 
an NPB and if the SNPOFF keyword is not coded. 


Format Register notation. 


Default None. 


iS NOTIFY=C LEAR 


Function Indicates that the user has completed handling the condition identified 
by the NOTIFY task information byte in the programmed resource 
control block and wants to set the field to 0. 


Format CLEAR. 


Default None. 


Lous ERCB= (register)— 


Function Specifies the register which contains the address of the user control 
block that is to be inserted into the specified programmed resource 
control block. 


Format Register notation. 
Default None. 
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Pe, IMBIT=——RES eT 
SET 


Function Sets or resets the immediate bit in the resource connection block (RCB). 
The immediate bit determines if the user's notify option, which is NCP 
system generated, is executed when the virtual route is held (virtual 
route blocked) or not held (virtual route unblocked). If the immediate bit 
is on, the user's notify option for this control block is executed. If the 
immediate bit is reset, the user's notify option is ignored. 


Format SET or RESET. 
Default None. 


Remarks This keyword is valid only if the CNTLBLK keyword specifies an NPB, 
an NLB, or an NLX. 


fe VVTI= ireaister)= 


Function Specifies the register containing the VVTI to be stored in the specified 
programmed resource control block. This keyword Is valid only when 
the CNTLBLK keyword specifies an NLX. 


Format Register notation. 


Default None. 
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NEOAXT—Generate an Accounting Routine Exit 


The NEOAXT macro generates the proper return linkage to NCP from IBM special 
products or user-written code accounting routines. When control is returned to 
NCP, register 6 must contain the same address that was passed to the IBM special 
products or user-written code accounting routine. Refer to Table 14 on page 444 
for attachment details for a user accounting notify routine. 


Syntax 
eee ee EOAXT 
name 
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NEOENQ—Pass a PIU to NCP Physical Services 


The NEOENQ macro passes to the NCP physical services any path information 
unit (PIU), such as INOP, that must flow in the NCP physical services-SSCP 
session. The PIU is then forwarded using the destination address field (DAF) 
already in the PIU, but with the origin address field (OAF) and sequence control of 
NCP physical services. The macro can be used only in program level 5. 


The PIU DSECT (XCXTPIU) must be included in the module invoking the NEOENQ 
macro. 


You must supply the virtual route vector table index (VVTI), either by coding the 
VVTI keyword or by including the VVTI in the PIU to be passed. 


Register 0 is not allowed for register parameters. 


Syntax 

oe (register) —_——> 
name 

Parameters 


»—PIUREG= (register) —________ 


Function Specifies the register containing the address of the PIU to be forwarded. 
Format Register notation. 

Default None. 

Remarks Register 1 is not allowed. 


The register specified for PIUREG cannot be the same as that specified 
for VVTI. 


L wti=(register)— 


Function Specifies the register containing the VVTI to be put in the PIU. 
Format Register notation. 
Default None. 


Remarks The register specified for the VVTI keyword cannot be the same as that 
specified for PIUREG. | 


You must code the VVTI keyword if the VVTI is not already included in 
the PIU being passed. 


If no register is specified, 0 is put in the PIU VVTI field. 
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NEOXPORT—Route PIUs to a Network Address 


Syntax 


The NEOXPORT macro routes path information units (PIUs) to the network address 
specified in the destination address field (DAF) of the PIU in user-written code 
instead of the XPORTVR macro. The NEOXPORT macro can be used only in 
program level 5. 


Register 0 is not allowed for register parameters. 


—NEOXPORT—PIUREG=(register) ,—RETURN=(register ) 
i OR (reg ) (reg ) 


n 


Parameters 


Ss BLKADDR= ipedistery=! 
LL WORKR= (resister) | 


L wrt- ineaister) = 


»—PIUREG=(register) ££ —_—_—_____ > 


Function Specifies the register containing the PIU to be sent. 
Format Register notation. 
Default None. 


Remarks This register may be the same as that specified for the RETURN reg- 
ister, but must be different from that coded for the BLKADDR or virtual 
route vector table index (VVTI) register. The Z latch is set to 1 if the 
PIU was routed. Register 1 is not allowed. 


>—RETURN= (register) ———__£_-__ 


Function Specifies the register to contain the return code for the operation. See 
the XPORTVR macro description for the definition of these return codes. 


Format Register notation. 
Default None. 


Remarks This register may be the same as that specified for any other keyword. 
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fs. BLKADDR= pea sen 


Function Specifies the address of the control block associated with the virtual 
route. 


Format Register notation. 

Default None. 

Remarks This register cannot be the same as the PIU register. 
You must code either this keyword or the VVTI keyword. 
When this keyword is coded, the WORKR keyword is required. 


If you code neither this keyword nor the VVTI keyword, the VVTI is 
extracted from the PIU. 


L WORKR=(register)— 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. You must code WORKR when you code the 
BLKADDR keyword. 


Format Register notation. 
Default None. 
Remarks This register cannot be the same as the PIU register. 


Only register 3, 5, or 7 can be used. 


= VVTI= ireuister)— 


Function Specifies the register that contains the VVTI. If you code this keyword, 
it overrides the VVTI contained in a control block. 


Format Register notation. 

Default None. 

Remarks This register cannot be the same as the PIU register. 
You must code either this keyword or the BLKADDR keyword. 
Register 1 is not allowed. 


If neither this Keyword nor the BLKADDR keyword is coded, the VVTI is 
extracted from the PIU. 
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NPAPIU—Send an NPA PIU to NetView Performance Monitor 


The NPAPIU macro sends network performance analyzer path information units 
(PIUs), accounting data request/response units (RUs), session start RUs, session 
end RUs, and session start/end RUs to NetView Performance Monitor (NPM). 


Register 6 must be a valid save area pointer. Register 0 is not allowed. 


Syntax 


a PIU=(register) ,—RETC=(register)———_——__$ _ cqyr 
name 
» SUPV=NO 
E SU —— 
» NCP=NO 
ae 


Parameters 


»— PIU=(register) > 


Function Specifies the register containing the address of the PIU to be sent. 
Format Register notation. 
Default None. 


Remarks This register should not be the same as that specified for the RETC 
keyword. Register 6 is not valid. 


»>—RETC= (register) -————_—_—_—— 


Function Specifies the register to receive the return code. The possible values 
are: 


X'0000'! PIU enqueued (PIU register will be 0 on output). 


X'0001' PIU in error. The PIU should be a FID1, FM data PIU with 
the data counts correct. 


X'0002' PIU not sent (accounting data send mode for IBM special 
products or user-written code is disabled). 


X'0003' Boundary session accounting function not supported by NCP. 


X'0004' PIU enqueued (however, accounting data send mode for IBM 
special products or user-written code is disabled because the 
virtual route is held). 
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Format Register notation. 
Default None. 


Remarks This register should not be the same as that used by the PIU keyword. 
Register 6 is invalid. 


For a RETC of X'0001', X'0002', and X'0003', the PIU is not 
enqueued; it is returned to the issuer of the macro. 


, SUPV=NO 
ns —e 
~Lyes 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 


» NCP=NO 
= — 
Lys 


Function Specifies the type of code generated on the basis of the issuer's storage 
protection key. NCP=YES indicates that the macros are to be expanded 
inline. NCP=NO indicates that an SVC call is to be used. 


Format YES or NO. 
Default NO. 
Remarks Specify this keyword only when SUPV=NO. 
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NPAQINFO—Retrieve SNA Session Information for User Line Control 


The NPAQINFO macro retrieves Systems Network Architecture (SNA) LU-LU 
session information for user line-control resources only. This macro can retrieve 
information about the logical unit, the session partner logical unit, or the procedure- 
correlation identifier (PCID). If information about more than one of these is to be 
retrieved, you must code NPAQINFO more than once. 


Register 6 must be a valid save area pointer. Register 0 is not allowed. 


Syntax 


cer GP Ll (register) ,—CBPTR=(register)——£$ ——————__—___—______"—> 
name 


L NapDR=(register)— 


L ELEM=(register)— 
L SUBA=(reoister)— 
L NETID=(register)— 


az PCID= (register)— 
» SUPV=NO 

E SU —— 
»NCP=NO 
ae 
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Parameters 


»>—RETC=(register) —@ $@— —— > 


Function Specifies the register to get the return code after execution of the 
NPAQINFO macro. The possible values are: 


X'0000' Successful; the requested information was returned. 


X'0001' The requested information was returned; the logical unit is 
not accounted for by the boundary session accounting func- 
tion. 


X'0002' The requested information was not returned; NCP does not 
include the boundary session accounting function. 


X'0003' The requested information was not returned; information is 
not available (TYPE=PCID only). 


Format Register notation. 
Default None. 
Remarks Must be an odd-numbered register. 


The register you specify must not be the same as that specified for any 
other keyword. 


Register 6 is invalid. 
>—CBPTR= (register) 


Function Specifies the register containing a pointer to the LU session control 
block (BSB). 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as that specified for any 
other keyword. 


Register 6 is invalid. 


Function Specifies what type of information is to be retrieved. This can be either 
PCID, logical unit (LU), or session partner logical unit (SPLU). 


Format PCID, LU, or SPLU. 
Default PCID. 
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L NADDR= peristee 


Function Specifies the register containing a pointer to the location that is to 
contain the name portion of the network-qualified network name 
(TYPE=LU or SPLV) or control point name (TYPE=PCID). 


Format Register notation. 
Default None. 


Remarks The name stored will be 8 bytes long, left-justified, and padded with 
blank spaces. 


The register you specify must not be the same as that specified for any 
other keyword. 


Register 6 is invalid. 


& ELEM=(register)— 


Function Specifies the register containing the element address (LU or SPLU). 
Format Register notation. 

Default None. 

Remarks This parameter is valid only if TYPE=LU or TYPE=SPLU. 


The register you specify must not be the same as that specified for any 
other keyword. 


Register 6 is invalid. 


L suBa=(register)— 


Function Specifies the register containing a pointer to the location that is to 
contain the subarea address (LU or SPLU). 


Format Register notation. 

Default None. 

Remarks This parameter is valid only if TYPE=LU or TYPE=SPLU. 
The subarea address stored will be 4 bytes long. 


The register you specify must not be the same as that specified for any 
other keyword. 


Register 6 is invalid. 
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NPAQINFO 


L NETID=(register)— 


Function 


Format 
Default 


Remarks 


Specifies the register containing a pointer to the location that is to 
contain the NETID portion of the network-qualified network name 
(TYPE=LU or TYPE=SPLU) or control point name (TYPE=PCID). 


Register notation. 
None. 


The NETID stored will be 8 bytes long, left-justified, and padded with 
blank spaces. 


The register you specify must not be the same as that specified for any 
other keyword. 


Register 6 is invalid. 


L pcip=(register)— 


Function 


Format 
Default 


Remarks 


Specifies the register that contains a pointer to the location that is to 
contain the fully qualified PCID. 


Register notation. 

None. 

This parameter is valid only if TYPE=PCID. 
The PCID stored will be 8 bytes long. 


The register you specify must not be the same as that specified for any 
other keyword. 


Register 6 is invalid. 


» SUPV=NO 
, SUPV=——NO 
Tie 


Function 


Format 
Default 


Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


YES or NO. 
NO. 
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,NCP=NO—— 
9 , es 
~Lyes 
Function Specifies the type of code generated based on the issuer's storage pro- 


tection key. NCP=YES indicates that the macros are to be expanded 
inline. NCP=NO indicates that an SVC call is to be used. 


Format YES or NO. 


Default NO. 
Remarks Specify this parameter only when SUPV=NO. 
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NPAQSTAT 


NPAQSTAT—Retrieve the Boundary Session Accounting Status 


The NPAQSTAT macro retrieves the status of the boundary session accounting 


Syntax 


function. 


Register 6 must be a valid save area pointer. Register 0 is not allowed. 


coama Gra ame aaa (register) ————_ SS > 
name 

» SUPV=NO 

»NCP=NO 


Parameters 


»>—STAT= (register) ————___ > 


Function Specifies the register to get the status of the boundary session 


Format 
Default 


accounting. The possible values are: 


X'0000' Accounting collection is included and the accounting data 
send mode for IBM special products or user-written code is 
enabled. 


X'0001' Accounting collection is included and the accounting data 
send mode for IBM special products or user-written code is 
disabled. 


X'0002' Accounting collection is not included. 


Register notation. 


None. 


Remarks Register 6 is invalid. 


, SUPV=NO 
: SUPV= = 
~Lyes 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 


Format 
Default 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


YES or NO. 
NO. 
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,NCP=NO 
,NCP=——N | 
Ly : : 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES indicates that the macros are to be expanded 
inline. NCP=NO indicates that an SVC call is to be used. 


Format YES or NO. 
Default NO. 
Remarks Specify this parameter only when SUPV=NO. 
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NPARMS—Get Information from a Programmed Resource Control 
Block 


The NPARMS macro tasks or subroutines get information from the programmed 
resource control blocks. Because this macro might use registers 1 and 6 as work 
registers, these registers might not be preserved when the macro is called. The 
descriptions of the keywords indicate which registers they use and if error codes 
are returned. Register 0 is not allowed for register parameters. 


The NPARMS macro without the CBTYPE keyword can be used only in a routine 
with storage protection key 1. When CBTYPE is specified, the NPARMS macro 
can be used in a routine executing with any storage protection key or in a routine 
that executes before storage keys are set. 


If the information requested is less than a full register, the information will be 
returned right-justified in the specified register with the remainder of the register set 
to 0. If CBTYPE is not specified and the control block whose address is supplied is 
not a valid programmed resource control block, or if a register that is not allowed is 
specified, the results are unpredictable and you must assume that none of your 
requests were satisfied. 


Note: You must code the CNTLBLK keyword and at least one, but not more than 
five, of the other keywords. 


Syntax 


aco | A PARMS—CNTLBLK= (register) ——_ > 
name 


aa: 


L FVTABLE= (pesisteny 


LL pTRLU- (nenister)— 
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L NoTIFY=(register)— 
L vECTABL=(register)— 
LL PTRLNK=(register)— 
L pTRPU=(register)— 
LL PARTNER=(register)— 
LL EXTENSN= (register) — 
LU EXTENSA (register)— 
L EXTENSC=(register)— 
L_ EXTENSS=(register)— 
LL SNPMASK=(register)— 
L_ wTl=(register)— 

Le Valis(register)— 


L NPMINFO=(register)— 


Parameters 


>—CNTLBLK=(register ) 


Function Specifies the register that contains the address of the control block. 
Format Register notation. 


Default None. 
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Function 


Format 
Default 


»CBTYPE= 
fe: LX 
VLB 


NPARMS 


This keyword has two functions: it specifies the type of programmed 
resource control block whose address is in the register specified by the 
CNTLBLK keyword, and it causes the generation of inline code instead 
of establishing the CALL linkage to the NPARMS service routine 
(CXDNPRM). All other keywords remain unchanged. 


NLB, NLX, NPB, or VLB. 


None. 


LU EVTABLE= (registen= | 


Function 


Format 
Default 
Errors 


Work 
Register 


Specifies the register to contain the address of the function vector table 
(FVT) associated with the control block. 


Register notation. 
None. 


None. 


None. 


L CURFVT=(register)— 


Function 


Format 
Default 
Errors 


Work 
Register 


Specifies the register to contain the address of the current task function 
vector index (byte). 


Register notation. 
None. 


None. 


Register 1. 
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hs, PREFVT= (register) 


Function Specifies the register to contain the address of the previous task func- 
tion vector index (byte). 


Format Register notation. 
Default None. 
Errors None. 


Work 
Register Register 1. 


L USERCB=(register)— 


Function Specifies the register to contain the address of the user control block 
associated with the specified control block. 


Format Register notation. 
Default Non. 
Errors None. 


Work 
Register None. 


LL NETADDR= ipegister)= 


Function Specifies the register to contain the element address (halfword) of the 
resource associated with the control block. 


Format Register notation. 
Default None. 
Errors None. 


Work 
Register Register 6. 


LU TYPE=(reaister)— | 


Function Specifies the register to contain the resource type (byte). The type 
bytes are VLB, X'01'; NPB, X'02'; NLB, X'04'; NLX, X'08'. 


Format Register notation. 
Default None. 
Errors None. 


Work 
Register Register 1. 
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NPARMS 


 prRLU=(register)— 


Function 


Format 
Default 
Errors 


Work 
Register 


Remarks 


Specifies the register to contain the address of the programmed 
resource logical unit block (NLB) associated with the control block. 


Register notation. 
None. 


None. 


None. 


The control block specified by the CNTLBLK keyword must be a pro- 
grammed resource logical unit block extension (NLX) for this keyword to 
be valid. 


L NOTIFY=(register)— 


Function 


Format 
Default 
Errors 


Work 
Register 


Specifies the register to contain the “notify” task information field (byte) 
of the FVT. 


Register notation. 
None. 


None. 


Register 1. 


L VECTABL= pein 


Function 


Format 
Default 
Errors 


Work 
Register 


Specifies the register to contain the address of the vector table con- 
taining the addresses of all the resources owned by this resource. If 
you code VECTABL, CNTLBLK must specify a virtual link block (VLB) or 
a programmed resource physical unit block (NPB). For example, if the 
address supplied via CNTLBLK is associated with a link (VLB), the 
macro will return the address of the physical unit vector table for that 
link. 


Register notation. 
None. 
An MNOTE is issued and the VECTABL register contains 0. 


None. 
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* PTRLNK= fregister)=! 


Function Specifies the register to contain the address of the VLB associated with 
the control block specified by the CNTLBLK keyword. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the PTRLNK register contains 0. 


Work 
Register None. 


Remarks For this keyword to be valid, the control block specified by the CNTLBLK 
keyword must be an NPB, an NLB, or an NLX. This keyword is not 
valid if CNTLBLK specifies an NLB that is an NCPNAU, because the 
NLB would have no associated VLB. 


L pTRPU- (penisten= 


Function Specifies the register to contain the address of the NPB associated with 
the control block specified by the CNTLBLK keyword. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the PTRPU register contains 0. 


Work 
Register None. 


Remarks The control block specified by the CNTLBLK keyword must be an NLB 
or an NLX for this keyword to be valid. This keyword is not valid if 
CNTLBLK specifies an NLB that is an NCPNAU, because the NLB 
would have no associated NPB. 


LL PARTNER- iregisten) = 


Function Specifies the register to contain the element address (halfword) of the 
session partner. The keyword is valid only if the control block specified 
by the CNTLBLK keyword is an NLX. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the PARTNER register contains 0. 


Work 
Register None. 
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»EXTENSN=(register) 


Function Specifies the register to contain the number (1 to 8) of this NLX. 
Format Register notation. 

Default None. 

Errors An MNOTE is issued and the EXTENSN register is set to 0. 


Work 
Register None. 


Es, EXTENSA=(regis tery 


Function Specifies the register to contain the address of the next available NLX 
for the logical unit. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the EXTENSA register contains 0. 


Work 
Register Register 1. 


Remarks This keyword is valid only if the control block specified by the CNTLBLK 
keyword is an NLX or an NLB. 


& EXTENSC= (register) — 


Function Specifies the register to contain the address of the NLX whose number 
is supplied in the same specified register. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the EXTENSC register contains 0. 


Work 
Register Registers 1 and 6. 


Remarks This keyword is valid only if the control block specified by the CNTLBLK 
keyword is an NLB or an NLX. 
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L EXTENSS=(register)— 


Function Specifies the register to contain the address of the NLX whose element 
address is supplied in the same specified register. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the EXTENSS register contains 0. 


Work 
Registers Registers 1 and 6. 


Remarks This keyword is valid only if the control block specified by the CNTLBLK 
keyword is an NLB or an NLX. 


LL SNPMASK= (register) — | 


Function Specifies the register to contain the SNPMASK field (byte). The 
SNPMASK field identifies the owning SSCP. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the SNPMASK register contains 0. 


Work 
Register Register 1. 


Remarks This keyword is not valid if the control block specified by the CNTLBLK 
keyword is an NLB or an NLX. 


L rc inégister)=! , | 


Function Specifies the register to contain the address of the resource connection 
block. 


Format Register notation. 
Default None. 
Errors An MNOTE is issued and the RCB register contains 0. 


Work 
Register Register 1. 


Remarks This keyword is valid only if the CNTLBLK keyword specifies an NPB, 
an NLB, or an NLX. 
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NPARMS 


L wtt=(register)— 


Function 


Format 
Default 
Errors 
Work 


Specifies the register to contain the virtual route vector table index 
(VVTI). 


Register notation. 
None. 
An MNOTE is issued and the VVTI register contains 0. 


Registers Registers 1 and 6. 


Remarks 


This keyword is valid only if the CNTLBLK keyword specifies an NPB, 
an NLB, or an NLX. 


L VRL= registers 


Function 


Format 
Default 
Errors 


Work 
Register 


Remarks 


Specifies the register to contain the address of the virtual route acti- 
vation work list. 


Register notation. 
None. 
An MNOTE is issued and the VRL register contains 0. 


Register 1. 


This keyword is valid only if the CNTBLK keyword specifies an NPB, an 
NLB, or an NLX. 


L NPMINFO= egisten= 


Function 


Format 
Default 
Errors 


Work 
Register 


Remarks 


Specifies the register to contain the NetView Performance Monitor 
(NPM) information byte that contains the NPM requests. The NPM 
requests are: 


X'01' Start collection for resource. 
X'02' Forward NPM data. 
X'03' Stop collection for resource. 


Register notation. 
None. 
An MNOTE is issued and the NPMINFO register contains 0. 


Register 1. 


This keyword is valid only if the control block specified by the CNTLBLK 
keyword specifies a VLB or an NPB. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 2. Macro Directory 247 


NVRID 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


NVRID—Format the Virtual Route Identifier List 


Syntax 


The NVRID macro generates an SVC service routine. The function of the macro 
and its service routine is to format your virtual route identifier (VRID) list. When 
your VRID list is formatted, the NVRID macro's service routine merges your VRID 
list into NCP's internal VRID list. When it is known, the destination subarea 
address (DSA) is stored in the formatted VRID list. See the VRACT and 
VRACTCK macros in this chapter. 


Register 0 is not allowed for register parameters. 


Note: Assume that the address passed to the NVRID macro for the formatted 
VRID list points to enough space for the VRID list. 


ee (register) 
name 


Parameters 


& DSA= (register) 


L wRID=(register)— 


Rael 
, SUPV=NO 


>—FVRID= (register) _-——_______$$_$_$_$£_$?$_______—__—_ . 


Function Specifies the register that contains the VRID list pointer. If you specify 
UVRID, this register contains a pointer to the location that is to contain 
the formatted VRID list. If you specify DSA, this register contains a 
pointer to a previously formatted VRID list. 


Format Absolute register notation. 
Default None. 
Remarks Neither register 1 nor register 6 is allowed. 


The register you specify must not be the same as that specified for any 
other keyword. 


L psa= (pegister)— 


Function Specifies the register that contains the DSA. 
Format Register notation. 


Default None. 
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Remarks Neither register 1 nor register 6 is allowed. 


The register you specify must not be the same as that specified for any 
other keyword. 


If this keyword is specified, assume that the FVRID keyword points to a 
previously formatted VRID list. 


The DSA is the address of a subarea within NCP network. 


L uvRID=(register)— 


Function Specifies the register that contains the pointer to the user's VRID list. 
Format Absolute register notation. 

Default None. 

Remarks Neither register 1 nor register 6 is allowed. 


The register you specify must not be the same as that specified for any 
other keyword. 


Your VRID list is expected to be in contiguous storage. 


Your VRID list is expected to be in the format of the virtual route list 
control vector (X'1B') or control vector X'0D'. 


You can omit this keyword if the FVRID keyword has a pointer to a pre- 
viously formatted VRID list. If you omit this keyword, you must specify 
the DSA keyword. 


sl 
, SUPV=NO 
Function Specifies that the issuer is running in level 5. 


Format NO. 
Default NO. 
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ORIF—Provide a Logical OR for an IF Macro 


The ORIF macro is used with the IF macro to provide a logical OR decision capa- 
bility in structured programming. It may follow an IF macro, an ANDIF macro, or 
another ORIF macro. 


Register 0 is not allowed for register parameters. 


Note: For efficiency, clarity, and better structure, you should use the IF macro with 
the AND or OR keyword, rather than using the ORIF macro. 


Syntax 


cua SG Hak F—keyword! ,—operator-—_—_——_ caja O_O 


name 
»—~, 0 
keyword2 »format 


For a description of the keywords, see the IF macro description. 


Example 
IF RGTEMP,EQ,X'80',1 
ORIF RGSTAT,EQ,X'40',1 
THEN ---- 
ELSE ---- 


lf the value in RGTEMP is X'80' or the value in RGSTAT is X'40', the instructions 
that are prefixed by the THEN macro are executed. If neither condition is met, the 
instructions that are prefixed by the ELSE macro are executed. 
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OUTICW1—Transfer the Contents of a Register to the ICW 


The OUTICW1 macro transfers the contents of a specified register to bits 0 to 15 
(SCF/PDF) of the initial control word (ICW). This macro is used in program levels 
1, 2, 3, and 4, and requires that the adapter control block (ACB), boundary session 
block (BCB), or |ICW DSECT be present and addressability be established. 


Register 0 is not allowed for register parameters. 


Syntax 
»>— —_ du 1c —(register) 
name 


im BCBREG= (bchcaddress #egisteni= 
»RESTORE=YES 
E RES TORE= — 
~Lyes 
, INDEX=YES 
E INDEX= nt 
YES 


Parameters 


>—(register) 


Function Specifies the register that contains the new SCF/PDF to be transferred 
to the ICW. 


Format Register notation. 


Default None. 


LC BCBREG= lichondineee: Fegisten) =. 


Function Specifies the register that contains the address of the BCB in which the 
contents of the out register are to be stored. 


Format Register notation. 


Default None. 
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, RESTORE=YES | 
» RESTORE=——-N 
= 
Function Specifies whether to reestablish the ACB address register. 


Format YES or NO. 
Default YES. 


» INDEX=YES 
» INDEX= 0 
at 
Function Specifies whether initialization of the BCB address is required. 


Format YES or NO. 
Default YES. 
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PACEMAP—Determine Virtual Route Pacing Window Sizes 


Syntax 


The PACEMAP macro produces inline code that uses local network identification 
(LNID), a subarea address, and the virtual route identifier (VRID) to determine the 
virtual route pacing window maximum and minimum sizes for the input virtual route 
if these sizes have been specified during NCP generation. If no window sizes have 
been specified, the macro returns a 0. The invoking routine must include the 
network vector table (NVT) and flow control parameter table (FCT) DSECTs 
(XCXTNVT and XCXTFCT) and must have an EXTRN for CXTNVTO, because 
PACEMAP issues the RSLVNET macro to get a pointer to the scanner interface 
trace (SIT) for the appropriate network. The invoking routine must also include an 
EXTRN for CXTNVT so that PACEMAP can access the NVT header and extension 
to get the FCT pointer. 


Register 0 is not allowed for register parameters. 


a ee LNID=(byte_register) ,—SUBA=(register) ,—VRID=(byte_register) ,_——____LL_» 
name 


>—WINDOW=(register) ,—WORK1=(register) ,—WORK2=(register) ——________LL___'#~< 


Parameters 


»>— LNID=(byte_register) ,— cc > 


Function Specifies the register containing the LNID. 
Format Register notation. 

Default None. 

Remarks The register must be a byte register. 


The register you specify must not be the same as that specified for any 
other keyword. 


The LNID is destroyed if this register is specified on another keyword. 


»>—SUBA=(register) , 


Function Specifies the register containing the subarea address of the device at 
the other end of the virtual route. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as that specified for any 
other keyword. 
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>—VRID=(byte_register), 


Function Specifies the register containing the virtual route identifier, which con- 
sists of the virtual route number and transmission priority. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as that specified for any 
other keyword; however, VRID and LNID may specify 2 different bytes 
of the same register. 


»>—WINDOW= (register) ,——@ @ —@ —@ . 


Function Specifies the register in which the window sizes will be returned. 
Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as that specified for any 
other keyword. 


You must specify an odd-numbered register. 


lf no window sizes have been specified, the content of this register is set 
to 0. If they have been specified, the minimum window size is in the 
high-order byte, and the maximum window size is in the low-order byte 
of the register. 


»>—WORK1= (register), — ——_—_—_—————_——$——$$__—__________—> 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as that specified for any 
other keyword. 


You must specify an odd-numbered register. 
>—WORK2= (register) ——_——_£——————_—________- _ 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks The register you specify must not be the same as that specified for any 
other keyword. 
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PCIL4—Update the Control Byte in the Level 4 Router Control Block 


The PCIL4 macro updates the proper control byte in the level 4 router control block 
(L4B) with all bits set to 1 to indicate a SET function and to 0 to indicate a RESET 
function. If TYPE=NSPEC, the control block remains unchanged. It then issues an 
OUT X'7D' to set the PCI latch if MODE=SET (except when TYPE=L45WT). If 
MODE=RESET, the macro issues an OUT X'77' to reset the program controlled 
interruption (PCl) latch only if TYPE=NSPEC. 


Whenever the level 4 or level 5 wait mask is reset by any routine (for example, the 
release service routine), that routine must ensure that all maskable-type PCI inter- 
rupt requests get processed. That routine, once the level 4 or level 5 wait mask is 
reset using the PCIL4 macro, should begin a PCl-hardware-interrupt-continued 
sequence so that the level 4 router can be reentered to process the PCI interrupt 
requests. Note that during the length of time the CCU is in the wait state, any PCI 
hardware interrupt for the level 4 or level 5 maskable-type PCI interrupt requests is 
reset by the router and an exit level 4 is executed. 


Whenever you want to issue the CXTL4B DSECT outside the PCIL4 macro, you 
must either know that an EXTRN will be generated by the macro or code a 
GBLA &L4B, to be used as follows: 


AIF (&L4B) . LABEL 
EXTRN CXTL4B 
&L4B SETA 1 


LABEL continue 


Register 0 is not allowed for register parameters. 


Syntax 


oe L4—TYPE= ee ee a a a ae aa 
name SET 


fe »WORK=(CXTL4B_base_register) a 
= BYTERG=(work_regis ter)— 


» PRESET=N 
E PRES aes 
YES 
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Parameters 
>—TYPE= 


Function Specifies the type of level 4 PCI being requested or controls the level 4 
PCI processing. | 


TYPE=L45WT causes the level 4 or level 5 wait mask to be set. This 
request does not indicate a specific type of PCI but instead controls the 
level 4 router processing. When level 5 is unable to carry out a lease, 
the level 4 or level 5 wait mask is set so that level 4 PCI lease 
requests, slowdown requests, dispatcher requests, and SVC requests 
are masked off. 


TYPE=LEASE causes a lease request. This occurs when level 5 has 
been disabled and parts of level 4 have been masked off because of an 
unsatisfied level 5 lease. When buffers again become available 
because they are released, this PCI type is issued so that level 4 gives 
control to a special entry point of the lease service routine. 


TYPE=SLODN causes a slowdown request. This PCI type is issued so 
that level 4 will give control to the system slowdown manager. 


TYPE=DISPT causes a dispatcher request. This PCI type causes the 
level 5 task dispatcher to be invoked. 


TYPE=MNDOF causes a MOSS-down request. This PCI type is issued 
when level 1, level 3, or the mailbox manager has determined that the 
maintenance and operator subsystem (MOSS) is down or offline and 
causes the level 4 MOSSDOWN processing to get control. 


TYPE=CRP causes a CRP entry service request. This PCI type occurs 
once an entry has been made in the check record pool by a level 1, 
level 2, or level 3 error-processing routine. This level 4 PCI causes the 
CRP processor in level 4 to get control so that a BER can be built from 
the CRP entry and sent to MOSS. 


TYPE=MOSSX causes a MOSS transfer request. Whenever any NCP 
or EP component wishes to send a mailbox-out request to MOSS, a 
MOSS transmit buffer is placed on the MOSS outbound queue, and this 
PCI type occurs. This PCI causes the MOSS transfer section of the 
mailbox manager to get control so that a mailbox out request can be 
sent to MOSS. 


TYPE=NSPEC causes a nonspecific request. This PCI type causes the 
level 4 PCI bit to be set or reset. No specific level 4 PCI type is set in 
the level 4 router control block. 


Format L45WT, LEASE, SLODN, DISPT, MDNOF, CRP, MOSSX, NSPEC. 
Default None. 


Remarks You must code this keyword. 
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sara (aa 
SET 


Function Specifies whether the PCI is to be set or reset. 


MODE=SET causes the proper flag byte in the level 4 router control 
block to be set to X'FF', unless TYPE=NSPEC. It also causes an OUT 
X'7D' to set the level 4 PCI hardware latch unless TYPE=L45WT. 


MODE=RESET causes the proper flag byte in the level 4 router control 
block to be set to X'00', unless TYPE=NSPEC. An OUT X'77' is 
issued to reset the PCIL4 latch only if TYPE=NSPEC or CRP. 


Format SET or RESET. 
Default None. 
Remarks You must code this keyword. 


If MODE=RESET, an OUT X'77' to reset the PCI latch is issued by the 
level 4 router and is not generated here unless TYPE=NSPEC or 
TYPE=CRP. 


LL WORK= (CX fie bésesnegister)— 


Function Specifies the register to use to establish addressability to the level 4 
router control block. 


Format Register notation. 
Default |The macro will save and use register 4. 


Remarks This parameter is optional. You can specify register 1, 2, 3, 4,5 or 7. If 
you do not specify a register, register 6 must point to an available save 
area. The generated code is more efficient if you code this parameter 
and have no need to save the specified register. 


os BY TERG= ( ererenisten=— 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register (byte) notation. 
Default The macro will save register 3 and use 3(1). 


Remarks This parameter is optional. You can specify register 1, 3, 5, or 7. If you 
do not specify a register, register 6 must point to an available save area. 
The generated code is more efficient if you code this parameter and 
have no need to save the specified register. 
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» PRESET=N 
=e “oat 
~Lyes 
Function Specifies whether the macro needs to establish addressability to the 
CXTL4B control block. 


If PRESET=YES, the macro does not generate the load address (LA) to 
establish addressability, but assumes addressability already exists in the 
register specified for the WORK keyword &WORK or its default (R4). 


If PRESET=NO, the macro generates the following: 
LA &WORK, CXTL4B 
Format YES or NO. 


Default NO. 


Remarks It is your responsibility to maintain addressability between calls to this 
macro if you want to code PRESET=YES. 
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PERFORM—Transfer Control to a Routine and Establish Return 

Linkage 
The PERFORM macro transfers control to a specified routine and establishes 
linkage back to the instruction immediately following the PERFORM macro state- 
ment. An optional keyword will update register 6 to point to the next save area in 
the save area chain. Register 6 should point to the current save area when the 
PERFORM macro is executed. The entry point to the routine to be performed 
should be established by the ROUTINE macro. The performed routine is respon- 
sible for saving and restoring any registers it alters. 


The PERFORM, ROUTINE, and RETURN macros provide a reentrant form of 
linkage if unique save areas are available. For example, levels 1, 3, 4, and 5 could 
share suitably coded common routines because each level has a separate save 
area chain. 


Register 0 is not allowed for register parameters. 


Note: If TRC=YES, the issuing module must contain an EXTRN for PERFTRC. 


Syntax 
socom ERPS ee ae cae 
name 


be RA= imecistens= 
, AREA=NO 
_— = 
YES 
» TRC=NO 
aeons am 
~Lyes 


Parameters 


>—routine_nane—————_———————— 


Function Specifies the routine to be given control. 
Format Register or label notation. 
Default None. 


Remarks Register 6 is not allowed. 
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L pa=(register)— , 


Function Specifies the return address register. 
Format Register notation. 

Default Register 7. 

Remarks Register 6 is not allowed. 


The RA=(r) specified on PERFORM must match the RA=(r) specified on 
the ROUTINE macro referred to by the routine name keyword. 


The linkage default is register 7 on both PERFORM and ROUTINE and 
is the preferred register to use. 


» AREA=NO 
=e = 
Les 


Function Specifies which save area is to be used. AREA=YES indicates that reg- 
ister 6 is to be updated to point to the next save area in the chain before 
performing the routine, then restored on the return. AREA=NO indicates 
that register 6 is to remain pointing to the current save area. 


Format YES or NO. 
Default NO. 


Remarks Code YES only if the current save area is in use. The current save area 
is in use if a SAVE macro with AREA=NO was issued prior to this 
PERFORM macro. The performed routine must use the next save area 
in that instance. Refer to the SAVE macro and the RESTORE macro 
for more information. 


» TRC=NO 
E TRC= — 
Lys 


Function Specifies whether an entry for the address of the PERFORM macro 
expansion will be added to the dispatch trace table during program exe- 


cution. 

Format YES or NO. 

Default NO.. 

Remarks Coding TRC=YES saves registers 1, 3, 4, and 5 in the current save 
area. 


Use of TRC=YES can degrade performance. 


Note: If TRC=YES, the issuing module must contain an EXTRN for 
PERFTRC. | 
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PIUDEALL—Deallocate a PIU from an Inbound Boundary Pool 


The PIUDEALL macro deallocates a path information unit (PIU) from the inbound 
boundary pool to which it has been allocated. If the PIU is marked as allocated, 
the virtual route vector table index (VVTI) is used to obtain the virtual route control 
block (VRB) where the count and threshold are kept. The count is decremented 
and the PIU is marked as deallocated. If the count is less than the threshold, the 
wake-up task (CXDCXSD) is triggered. 


Syntax 
oi RCA (RE atk (register) ,—WORKR= (Bonk: ee i ee ee eee 


name 
, SUPV=YES 
E SU —— 
» ENABLE3=YES 
EC Ts 


Parameters 


»>—PIU=(register) ,—_—_—__—_ 


Function Specifies the register containing the address of the PIU that is to be 
deallocated. 


Format Absolute register notation. 
Default None. 


Remarks The register you specify must not be the same as the one specified for 
the WORKR keyword. 


Register 6 is not allowed with SUPV=YES. 
Register 3 or 7 is preferred. 
Register 1 is not allowed with SUPV=NO. 


»>—WORKR= a a ae ne 


Function Specifies one or two work registers, the contents of which may be 
altered during execution of the macro. 


Format You can specify a maximum of two registers from register 1, 2, 3, 4, 5, 
or 7. 


Default None. 
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Remarks The registers you specify must not be the same as the one specified for 
the PIU keyword. 


This parameter is not valid with SUPV=NO. 


» SUPV=YES 
ey =a 
~Lyes 


Function Specifies whether the macro is to issue a supervisor request to level 4 
or link directly to the PIUDEALL service routine. 


Format YES or NO 
Default YES. 


» ENABLE3=YES 
—, —— 
Lys 
Function Specifies whether level 3 interupts are enabled at the completion of the 
PIU deallocation. If ENABLE3=YES, both level 2 and level 3 interrupts 
are enabled at the completion of the PIU deallocation. If ENABLES=NO, 


a level 4 routine inhibits level 3 interrupts and issues a PIU deallocation. 
Only level 2 interrupts are enabled at the completion of the PIU deallo- 


cation. 
Format YES or NO 
Default YES. 
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PIUEND 


PIUEND—Get the Last PIU Data Byte and a Buffer Pointer 


The PIUEND macro returns a pointer to the last buffer with data and the last byte 
with data in the path information unit (PIU). The macro requires a pointer to the 
first buffer of the PIU. 


You must put a valid save area pointer in register 6. If the PIU is an FID1 witha 
correct transmission header data count, code the FIDX keyword as 1 for efficiency. 
In all other cases, code FIDX as 0. 


The buffer data counts in the PIU must be correct before you call the macro. 


Register 0 is not allowed for register parameters. 


Syntax 


>>—7 ____, PIVEND—-PIUP= (register) »—FIDX=(byte_register) ,—LBUF=(register) ,—LBYTE=(register )————> 
name 

, SUPV=NO 

, SUPV=——NO 
— 

,NCP=NO 

ar a 

~Lygs 


Parameters 


BaD TUS (eis Cer ge 


Function 
Format 
Default 


Remarks 


Specifies the register containing a pointer to the first buffer of the PIU. 
Register notation. 
None. 


Register 6 is not allowed. The register you specify must not be the 
same as that specified for any other keyword. The value in the selected 
register is preserved. | 


»>—FIDX=(byte_register) ,————$$ > 


Function 


Format 
Default 


Specifies a byte register containing one of the two values shown below: 


X'01' Use this value only when the PIU is a FID1 with a correct data 
count in the transmission header. 

X'00' Use this value for all other cases or when the FID type is not 
known. 


Byte register notation. 


None. 
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Remarks The register must be the high or low byte of an odd-numbered register 
and must be used only for this keyword. The value of this register is 
preserved. 


FIDX=X'00' works for all cases. If you know that the PIU is FID1, use 
X'01' for efficiency. 


»>—LBUF=(register) ,_-_@_ ____——_—_____—_———_———————— 


Function Specifies the register that will contain the pointer to the last buffer in the 
PIU that contains data. 


Format Register notation. 
Default None. 


Remarks Register 6 is not allowed. The register you specify must not be the 
same as that specified for any other keyword. 


»>—1BYTE=(register) —_—_  _____—— 


Function Specifies the register that will contain the pointer to the last byte of data 
in the PIU. 


Format Register notation. 
Default None. 


Remarks Register 6 is not allowed. The register you specify must not be the 
same as that specified for any other keyword. 


» SUPVY=NO 
» SUPV=——NO 
= 


Function Specifies the level in which the issuer is running. SUPV=NO indicates 
that the issuer is running in level 5. SUPV=YES indicates that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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»NCP=NO 
= a 
Lives 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES indicates that the macro is to be expanded 
inline. NCP=NO indicates that an SVC call is to be used. 


Format YES or NO. 
Default NO. 
Remarks NCP is valid only when SUPV=NO. 
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POINT—Return the Address of the First Element in a Queue 


The POINT macro returns the address of the first element. This first element can 
be either a block contro! unit (BCU) or a queue control block (QCB) that is queued 
on a specified system queue without dequeuing the element. You can also use the 
POINT macro to determine if the specified system queue is empty without returning 
the address of the first element (when present). The Z latch is set to 1 if the queue 
is empty and to 0 if it is not empty. The C latch is set opposite to the Z latch. 


Register 0 is not allowed for register parameters. 


Syntax 


Pee ee ne lement_address_register LLL" 
name | 


(ach address) = 


» SUPV=NO 
» SUPV=——NO 
ie 


Parameters 


»—element_address_register ,——@£ ———————__________—_____» 


Function Specifies a register to receive the address of the located element. 
Format Register notation. 
Default None. 


Remarks lf there are currently no elements queued on the specified queue, the 
address in the specified register is set to 0. 


Register 3 is standard. 


L (qcb_address) a 


Function Specifies the address of the QCB governing the queue in which the 
element is located. 


Format Register or label notation. 
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Default If SUPV=YES, there is no default. If SUPV=NO, the QCB that activated 
the issuing task is assumed. 


Remarks If NCP=NO, register 1 is not allowed. 
This keyword must be specified if SUPV=NO and NCP=YES. 


, EMPTY=——(branch_address) 
SETNC 
SETZ 


SETZNC 


Function Either specifies the address to be given control or specifies whether the 
C latch, Z latch, or both are to indicate whether the specified queue is 
currently empty. 


Format Label notation, register notation, SETZNC, SETZ or SETNC. 
Default The next instruction after the macro instruction is given control. 
Remarks Register 1 is not allowed. 


For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 
specified queue is empty or to 0 if not empty. For SETZNC or SETNC, 
the C latch is set to 0 if the specified queue is empty or to 1 if not 


empty. 


»NCP=NO 
pa — 
~Lyes 
Function Specifies the type of code generated based on the issuer's storage pro- 


tection key. Valid only when SUPV=NO._ If NCP=YES, inline code is 
generated. If NCP=NO, an SVC is generated. 


Format YES or NO. 
Default NO. 


» SUPV=NO 
, SUPV=——NO 
= 
Function Specifies the level in which the user is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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POSTUACB—Implement User Line Control 


The POSTUACB macro in your level 2 interrupt handler implements user line 
control. It places the user adapter control block (UACB) directly into the NCP's 
communication interrupt control program (CICP) queue and causes a program- 
controlled interrupt to level 3. Use the FINDUACB macro to obtain the UACB 
pointer. The UACB pointer must be in the register specified by the VACBREG 
keyword. When your level 2 interrupt handler is finished executing, it must place 
the UACB pointer into register 2. 


After the POSTUACB macro is executed, the level 3 interrupt processor does the 
following: 

e Tests to see if the device is supported by NCP or by user code 

e Retrieves the UACB 


e Transfers control to the address in the GCBL3 field of the group control block 
(GCB). 


The level 3 routine obtains the UACB pointer from register 2. 


Note: The use of this macro requires that the assembly include the DSECTs 
XCXTGCB and XCXTXDA. Addressing is handled internally by the macro. 


Syntax 
ree rea eee (register) 
name | 


» ROUT INE=NO— 
E ROUT INE= i 
Lyes 


Parameters 


»>—UACBREG= (register) 


Function Specifies the register containing the UACB pointer to be passed to the 
level 3 routine. 


Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 
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, ROUT INE=NO—— 
»ROUTINE=——N 
Te 
Function Specifies whether you want the code to expand inline to post the UACB 


(ROUTINE=NO) or branch-and-link to a common routine (CKBDQACE) 
that posts the UACB (ROUTINE=YES). ROUTINE=NO expands the 


macro inline. 
Format YES or NO. 
Default NO. 


Remarks If you code ROUTINE=YES, the UACB must be in register 2 before the 
macro is invoked. Also, the contents of registers 1, 4, and 7 are 
destroyed. 
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PRELEASE—Reserve Buffers for Future Use 


The PRELEASE macro allows a program to reserve one or more buffers for future 
use. lf the buffers requested are not available, the requesting program has the 
option of being posted until the buffers are available. Other level 5 tasks continue 
while the requesting program waits. When the buffers become available the task is 
dispatched. 


Syntax 
oT op eee E—COUNT=——buf. Te a gr ae ea 
name Ws(pyte-register) 


, TYPE=CON 
eae =—aet | 


»POST=NO 
»POST=——NO 
<— : 
Rieshiiall 
, SUPV=NO 


Parameters 
>—COUNT= BUT ee ele ee 
(byte_register) 


Function Specifies the number of buffers to be preleased. 


Format Low-byte register (absolute notation) or numerical value (absolute nota- 
tion). 


Default None. 


Remarks Registers 0 and 1 are not allowed. 


, TYPE=CON 
, 1YPE=——COND 
=o 


Function Specifies whether the PRELEASE request is conditional or uncondi- 
tional. 


Format COND or UC. 
Default COND. 
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PRELEASE 


Remarks !n a conditional request (TYPE=COND), buffers will not be preleased if 


the number specified causes the free-buffer count to drop below the 
slowdown threshold. 


An unconditional request (TYPE=UC) will be honored if enough buffers 
are available. 


In earlier releases of NCP, TYPE=SLDN and TYPE=CWALL indicated 
that the PRELEASE request was bounded by the slowdown and com- 
munications wall thresholds, respectively. Revisions to the PRELEASE 
macro replace TYPE=SLDN with TYPE=COND, and TYPE=CWALL with 
TYPE=UC. 


» EMPTY=SETCNZ 

»EMPTY=——SETC 
SETCNZ 
SETNZ 


Function 


Format 
Default 


Remarks 


Specifies that either the C latch or Z latch is set if PRELEASE cannot be 
satisfied. 


SETC, SETNZ, or SETCNZ (either C, or NOT 2). 

SETCNZ. 

If PRELEASE is satisfied, C latch is set to 0 and Z latch is set to 1. 

If PRELEASE is not satisfied, C latch is set to 1 and Z latch is set to 0. 


»POST=NO 
3 POST= = 
~Lyes 


Function 


Format 
Default 


Remarks 


Specifies whether the current queue control block (QCB) is posted to 
wait until one or more buffers are available. 


YES or NO. 

NO. 

If POST=YES and the PRELEASE is not satisfied, the following occurs: 
e This PRELEASE is flagged as being unsuccessful. 


e The task is queued on a prelease dispatch queue for later dis- 
patching. 


e When buffers are available, they are preleased and the task is dis- 
patched. 


When a task is dispatched from a prelease dispatch queue (uncondi- 
tional or conditional) the buffers will have been preleased before exe- 
cution at the task entry point. Check the preleased triggered bit of the 
QCB (in the XYZSTATP field) to see if the buffers have already been 
preleased. 
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For example: 


IF 'preleased triggered' bit is OFF 
THEN (dispatched off normal queue) 
PRELEASE POST =YES,... 
IF not successful, 
THEN 
SYSXIT QPOST=NO (if POST=YES on PRELEASE) 
ENDIF 
ENDIF 


iia 
» SUPV=NO 
Function Specifies that the issuer is running in level 5. 


Format NO. 
Default NO. 
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PURGQCB—Purge a Queue 
The PURGQCB macro purges a queue using the DEQUE and RELEASE macros 
when given a pointer to a queue control block (QCB). 


Register 0 is not allowed for register parameters. 


Syntax 
ease Ir (i RGQCB—QCBP= (register) ,—WORK= (register) -—i@ —O—_——___—_———> 


name 
» CONT=NO 
E ——— 
, SUPV=NO : 
: SU —— 


Parameters 


»>—QCBP=(register) ,———@______? , 


Function Specifies the register containing a pointer to the QCB for the queue to 
be purged. 


Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 6 is allowed. The register cannot be the 
same as that used for WORK. The value of the register is preserved. 
Register 2 is standard. The elements on the QCB must contain event 
control blocks (ECBs). 


>—WORK= (register )-———£@——H—_——_—_—_> 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 6 is allowed. The register cannot be the 
same as that used for QCBP. The contents of the register are not pre- 
served. Register 3 is standard. 
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» CONT=NO 
a — | 
Les 
Function Specifies whether the queue is a contention queue. 


Format YES or NO. 
Default NO. 


» SUPV=NO 
7 — | 
~Lyes 
Function Specifies the level in which the issuer is running. SUPV=NO indicates 


that the issuer is running in level 5. SUPV=YES indicates that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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PUTBYTE—Store a Data Byte from a Register into a BCU 


The PUTBYTE macro stores a specified data byte from a register into a specified 
position in a block control unit (BCU). 


The position into which the register is to be stored is specified in two ways. The 
first way is to specify a displacement value in the DISP keyword. Using this dis- 
placement value, the supervisor calculates the appropriate position in the appro- 
priate buffer of the BCU and stores the register byte. The supervisor then 
increments the displacement value by 1 and saves it. The second way is to omit 
the DISP keyword. The supervisor uses the displacement saved from the last 
PUTBYTE macro to calculate the position where the byte is to be stored. It then 
increments the displacement value by 1 and saves it. 


You can use the PUTBYTE macro in two modes, sequential and update. Use 
sequential mode when a BCU is being built 1 byte at a time. In this mode, the 
PUTBYTE macro causes the text count in the basic transmission unit (BTU) and 
the data count in the buffer to be incremented by 1. Use update mode when the 
data within an existing BCU is being modified. In update mode, the PUTBYTE 
macro alters neither the BTU text count nor the buffer data count. 


Register 0 is not allowed for register parameters. 


Syntax 


p> — 7 PUTBYTE—(data_b yte) ,—(bcu_address ) S$ SS 
name 


LL pisp=aisptecenent=— 


x END=branch address— 
,UPDATE=N 
— — 
Leyes 


Parameters 
»>—(data_byte) , 


Function Specifies the register containing the data byte to be stored. 
Format Byte register notation. 
Default None. 


Remarks Register 1(0) is standard. 
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»—(bcu_address) 


Function Specifies the register containing the address of the first byte of the first 
buffer of the BCU. 


Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. 


L pisp=displacement— 


Function Specifies the displacement from the first byte in the BCU to the position 
where the data byte is to be stored. 


Format Absolute or register notation. 
Default Computed value is used. 


Remarks Register 1 is not allowed. 


5 EN Fe aranch address 


Function Specifies the address to be given control if the specified or computed 
displacement exceeds the total size of the BCU. 


Format Register or label notation. 


Default The issuing program tests register 1(1) bit 0. If the bit tested is 0, the 
byte was not stored successfully. 


Remarks Register 1 is not allowed. 


»UPDATE=N 
en a 
~Lyes 
Function Specifies the mode in which the PUTBYTE macro is to be used. 
UPDATE=YES specifies update mode; UPDATE=NO specifies sequen- 


tial mode. 
Format YES or NO. 
Default NO. 
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QCB—Define Storage for a System Queue Control Block 


The queue control block (QCB) macro defines the storage required to establish a 
system queue control block. The name field is optional for work queues and is 
required for all other types of queues. 


Syntax 
panos! 


» TAS ae (eos try_potnt 
, REENT=NO 
»REENT= 0 
YES 
»MCB=major_control_block_name 


Es PRKEY=—-absolute-|— 


Le, EXTRN=0— 


Parameters 


Function Specifies the type of QCB to be generated. Code the block handling 
routine (BHR) if the associated task executes an EXECBHR macroin- 
struction. 


LY43-0032-01 © Copyright IBM Com. 1988, 1994 Chapter 2. Macro Directory 277 


QCB “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Format INPUT, PSEUDO, WORK, or BHR. 
Default INPUT. 


» TAS oat (l- k_entry_point | 


Function Specifies the entry point that is to be activated when data is enqueued 
to the QCB being defined. 


Format Label notation. Entry point of the task to be activated, or 0 if it is not 
known at assembly. 


Default None. 


Remarks If TYPE=WORK, this keyword has no meaning; otherwise, it is required. 


» REENT=NO 
E een 
YES 


Function Specifies whether the task associated with the queue being defined is 
reentrant, that is, it is associated with more than one QCB and issues a 


WAIT macro. 
Format YES or NO. 
Default NO. 


Remarks If TYPE=WORK, this keyword has no meaning. 


LL wcB=maj or_contro i pisee yanien. 


Function Specifies the name of the major control block within which the QCB is 
being assembled. 


Format Label notation. 
Default None. 
Remarks If TYPE=WORK, this keyword has no meaning. 


L PRKEY=—[-absolute-7— 


Function Specifies the protection key under which the task associated with the 
queue being defined executes. 


Format Any value from 0 to 7. 
Default 0. 
Remarks lf TYPE=WORK, this keyword has no meaning. 
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Function Specifies the initial status of the QCB as either appendage, immediate, 
productive, or nonproductive. 


Format The format codes are: 


A Appendage (highest priority) 

| Immediate (second-highest priority) 
P —_ Productive (third-highest priority) 
NP Nonproductive (lowest priority). 


Default PP. 


Remarks The status of the QCB Is the dispatching priority that is used when the 
QCB is triggered. 


If TYPE=WORK, this keyword has no meaning. 


* EXTRN=0— 


Function Suppresses the generation of an external reference to the task entry 
point specified by TASK. Specify this keyword if the QCB macro is in 
the same module as its task entry point. 


Remarks If TYPE=WORK, this keyword has no meaning. 
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QPOST—Flag a Task as Ready and Eligible for Reactivation 


The QPOST macro flags a specified task as being in the ready state and eligible 
for reactivation. If any element is currently enqueued on the specified task input 
queue, the task is triggered and scheduled for execution. 


For additional information on how the QPOST macro affects task states, refer to 
“Task Management” in NCP and EP Reference. 


Register 0 is not allowed for register parameters. 


Note: This macro uses the current save area and assumes that this save area 
can be overwritten. 


Syntax 
name 


“Lgheodiress)222020=OCO™C~C“—s~—S~s~s™sSSSSSsSs~C‘“Ss™SSCi‘SCS 
» TRIGGER=NO 
, SUPV=NO 


Parameters 
a (qcb_address) a 


Function Specifies the register containing the address of the input or pseudoinput 
queue control block (QCB) governing the task to be flagged. 


Format Register or label notation. 


Default If SUPV=YES, there is no default. If SUPV=NO, the QCB that activated 
the issuing task is posted. 
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» TRIGGER=NO 
<a ene 
YES 


Function Specifies whether the specified task is to be rescheduled (YES) or 
merely flagged as ready (NO). 


Format YES or NO. 
Default YES. 


» SUPV=NO 
» SUPV=—-N 
= 
Function Specifies whether the macro is to issue a supervisor request to level 4 
or is to link directly to the QPOST routine. 


Format YES or NO. 
Default NO. 


L WORKR= CSucrk peois ae 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default No work registers. 


Remarks Register 6 is not allowed. 
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RCBSCAN—Get the Address of an RCB in a Chain Associated with a 


Virtual Route 


Syntax 


The RCBSCAN macro scans the chain of resource connection blocks (RCBs) asso- 
ciated with a virtual route and returns the address and type of the next RCB on the 
chain. This macro expands inline. 


Register 0 is not allowed for register parameters. 


ziceaarr NT (cde i (register) ,—NEXTRCB= (register) 


, LAST=SETZNC | | 
,LAST=——SETNC 
Eset 
SETZNC 


L type=(register)— 


name 


Parameters 
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»>—BLOCK= (register) ,—_—_—_____ > 


Function Specifies the register containing the starting RCB or VRB address in the 


Format 
Default 


chain to scan. 
Register notation. 


None. 


Remarks The specified register must not be the same as that specified for the 


NEXTRCB or TYPE keywords. 


lf an address of a VRB is input, the first RCB in the chain is returned. 


»>—NEXTRCB= (register) _-_—-—- > 


Function Specifies the register that returns the address of the next RCB on the 


Format 
Default 


chain of RCBs associated with a virtual route. . 
Register notation. 


None. 


Remarks The content of the specified register is set to 0 if there are no more 


RCBs on the chain. 


The specified register must not be the same as that specified for the 
BLOCK or TYPE keywords. 
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» LAST=SETZNC 

, LAST=——SETNC 
SETZ 
SETZNC 


Function Specifies whether the C latch, the Z latch, or both are to indicate if the 
end of the chain is found. 


Format SETZ, SETNC, or SETZNC. 
Default SETZNC. 


Remarks For SETZNC or SETZ, the Z latch is set to 1 if this is not the end of the 
chain or to 0 if this is the end. For SETZNC or SETNC, the C latch is 
set to 0 if this is not the last RCB on the chain or to 1 if this is the last. 


The conditions for setting the C and Z latches as described above apply 
when the VRB has no RCBs chained to it. 


U tyPe=(register)— 


Function Specifies the register in which the RCBSCAN macro returns the block 
type from the RCBBLK field. 


Format Byte register notation. 
Default None. 
Remarks If the chain is empty, the contents of this register is set to 0. 


The specified register must not be the same as that specified for the 
NEXTRCB or BLOCK keywords. 
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RELEASE—Return a Buffer or Buffer Chain to the System Free-Buffer 
Pool 


The RELEASE macro returns a buffer or buffer chain to the system free-buffer pool. 


Register 0 is not allowed for register parameters. 


Note: This macro uses the current save area and assumes that this save area 
can be overwritten. 


Syntax 


ee E—(buffer_address ) 
name 
» ECB=NO 
me Ty = 
» SENS=NO 
: —— 
, SUPV=NO | 
oe —— 
, INLINE=N 
a —— 
, ENABLE3=YES 
a mae 
iat CS fork reaiste a 


Parameters 


»—(buffer_address) 


Function Specifies the register containing the address of the buffer or buffer chain 
to be released. 


Format Register notation. 


Default None. 
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Remarks Register 1 is not allowed. 
lf SUPV=YES, register 3 is standard and register 6 is not allowed. 


The buffer address must be specified as register 3 if INLINE=YES is 
specified. 


» ECB=NO 
, ECB=——N 
x : 


Function Specifies whether the first or only buffer being released contains an 
event control block (ECB). 


Format YES or NO. 


Default NO. 
Remarks This keyword is ignored if INLINE=YES, unless the system is in slow- 
down mode. 


For ECB=YES, an ECB initialization function must have been carried out 
before the RELEASE macro is invoked. 


The ECB keyword does not affect the number of buffers being released. 


» SENS=NO 
, SENS=——-NO 
= 
Function Specifies whether the data in the buffers is sensitive. 
Format YES or NO. 


Default NO. 


Remarks YES specifies that the data is sensitive and that the supervisor is to set 
the buffers to 0 before returning them to the system free-buffer pool. 


This keyword is ignored if INLINE=YES, unless the system is in slow- 
down mode. 


, SUPV=NO 
es “= 
~Lyes 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES indicates that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
Remarks You must specify SUPV=YES if you specify INLINE=YES. 
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, INLINE=N 
er a | 
~Lyes 
Function YES specifies that a fast inline release will be generated. The inline 
code checks whether the system is in slowdown or pseudoslowdown 


mode. If the system is in slowdown mode, existing release code will be 
executed; otherwise, a “fast” release will do the following: 


e Chain the chain of buffers passed in register 3 to the free-buffer 
pool chain 


e Update the buffer tag in each buffer of the chain that is passed 
e Update the current free-buffer pool count. 
Format YES or NO. 
Default NO. 
Remarks SENS and ECB are ignored if the fast inline code is executed. 
You must specify SUPV=YES. 
The buffer address must be in register 3. 


If INLINE=YES is coded, dsect XCXTABN must be included in the 
assembly. 


» ENABLE3=YES 
poms — 
“Lys 
Function Specifies whether level 3 interrupts are to be enabled at the completion 
of the RELEASE. If ENABLE3=YES, both level 2 and level 3 interrupts 
are enabled at the completion of the RELEASE. ENABLE3=NO allows 


a level 4 routine to inhibit level 3 interrupts and then issue a RELEASE, 
and only level 2 interrupts will be enabled at the completion of the 


RELEASE. 
Format YES or NO. 
Default YES. 


Remarks This parameter is valid only when you code SUPV=YES. 


, WORKR= (dork reais te pee | 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default No work registers. 
Remarks Register 6 is not allowed. WORKR is valid only if INLINE=YES. 
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RESET—Enable an Interrupt Level 


The RESET macro loads a specified register with the appropriate masks and issues 
an output instruction to allow interrupts at the specified interrupt levels. This macro 
can be used in program levels 1, 2, 3, and 4. 


Note: This macro can be executed by interrupt-level code only. 


Syntax 


RESET »—(register ) A 
name level 
eae 
» SUPV=YES 
——s 
Parameters 


level 
oe 


Function Specifies the interrupt level to be unmasked. 


Format Absolute notation. If more than one level is to be unmasked, the list of 
levels is enclosed in parentheses. 


Default The supervisor assumes that the mask has been preloaded into a speci- 
fied register. 


»>—(register )— 


Function Specifies a register to contain the mask to enable the desired interrupt 
level. | 


Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 
Beseadieicedt 
-y SUPV=YES 
Function Specifies that the issuer is running in an interrupt level. 


Format YES. 
Default YES. 
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RESTORE—Restore Registers 
The RESTORE macro does the following: 
e Updates register 6 to point to the previous save area in the save area chain. 
e Restores the specified registers from the save area addressed by register 6. 


e Loads the instruction address register (IAR) with the address of the return point 
specified in the save area addressed by register 6. 


Register 0 is not allowed for register parameters. 


Syntax 
me __y_ RESTORE = ist fale »>7—RTRN= ee, 
name ee ies 


‘. WORKR= (3M oneves eae 
= AREA -No—— 
YES 


Parameters 


ee ist A: se 
I ee 


Function Specifies the registers to be restored. (register,...) specifies the 
individual registers to be restored. (rx,ry,INCL) specifies a range of 
registers to be restored; INCL must be included. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. 


Default No registers are restored. 


Remarks If you specify a register with the (register,...) format and you specify 
the same register for WORKR, the contents of the register will not be 
restored. 


If you specify (rx,ry, INCL), the WORKR keyword is not valid. 
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saa a aa I 
YES 


Function Specifies whether the instruction address register (IAR) is to be loaded. 
RTRN=YES indicates that the IAR is to be loaded with the address of a 
return point specified in the save area addressed by register 6. 
RTRN=NO indicates that the IAR is not to be loaded. 


Format YES or NO. 
Default None. 


Remarks You must code this keyword. 


L WORKR= (Lo rk_regis ate 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format You can use registers 1, 2, 3, 4,5, and 7. You cannot use equated 
values. 


Default No work registers. All registers specified in the first parameter are 
restored. 


Remarks If you specify a register in the first parameter with the (register,...) 
format, and you specify the same register for WORKR, the contents of 
the register will not be restored. If you specify (rx,ry, INCL) for the first 
parameter, WORKR is not valid. 


L aREA—-No—— 
YES 


Function Specifies whether register 6 is to be updated. AREA=YES indicates that 
before the registers are restored, register 6 is to be updated to point to 
the previous save area in the chain. AREA=NO indicates that register 6 
is not to be updated. 


Format YES or NO. 


Default If you code a SAVE macro with AREA=YES and do not code a SAVE or 
RESTORE macro between that SAVE and this RESTORE, the default is 
YES; otherwise, the default is NO. 
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RETURN—Restore Registers and Return Control after a ROUTINE 


Macro 


Syntax 


sa RN 
name 


Parameters 


The RETURN macro restores the registers saved by the ROUTINE macro and 
returns control to the instruction following the PERFORM macro in the PERFORM, 
ROUTINE, RETURN macro sequence. Register 6 is updated to point to the pre- 
vious save area. If no other ROUTINE macro is executed between a ROUTINE 
macro and its RETURN, you can code more than one RETURN for a single 
ROUTINE macro in the assembly of the routine. The RETURN macro must be 
executed following a ROUTINE macro and must follow its associated ROUTINE 
macro in the assembly of the routine. 


The values saved by the ROUTINE macro and used by RETURN can be over- 
ridden by the RESTORE macro. 


Litiieeebigaieled 
(rx, ry, INCL) 
, AREA=YES | 
—s a 
Lys 


ee en ee 
(rx, ry, INCL) 


Function Specifies the registers to be restored. (register,...) specifies the 
individual registers to be restored. (rx,ry,INCL) specifies a range of 
registers to be restored. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. 


Default No registers are restored. 


Remarks The value of the SAVE keyword on the ROUTINE macro is passed to 
the RETURN macro. Any value specified in the RESTORE keyword 
overrides the value passed from the ROUTINE macro. 


Register 0 is not allowed. 
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» AREA=YES 
—r a 
Lives 


Function Specifies whether register 6 is to be updated. AREA=YES indicates that 
register 6 is to be updated to point to the previous save area in the 
chain before the registers are restored. AREA=NO indicates that the 
registers are to be restored from the save area currently pointed to by 


register 6. 
Format YES or NO. 
Default YES. 


Remarks The value of the AREA keyword on the ROUTINE macro is passed to 
the RETURN macro. Any value specified in the AREA keyword over- 
rides the value passed from the ROUTINE macro. 


Use AREA=NO only in a routine that performs no other routines. 
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RNSVC—Generate Linkage from Level 5 to the Supervisor 
SVC-Handling Routine 


Syntax 


The RNSVC macro, within a supervisor call (SVC) macro, generates the standard 
linkage from level 5 to the supervisor SVC-handling routine. See Chapter 1 for a 
list of the SVC codes and associated macros and for a description of the linkage 
between levels 5 and 4. 


ceca RE RE »—oneprm,—b0,—b1 ,—parnl ,—parn2 ,—________________—_—__— 
name 


Parameters 


L parm3—| 


Ljpvars=! 


Spares. 


Saree 


>—code, 


Function Specifies the SVC code. 
Format Numeric value. 
Default None. 


Remarks This value is put in byte 2, bits 0 to 6, 
>—oneprn ,—_—__________ > 


Function Specifies the value of the one-parm flag (byte 2, bit 7) in the SVC 
linkage. 


Format Oor1. 
Default None. 


Remarks If this value is 1, byte 3 contains one input parameter in bits 2 to 4. The 
rest of the bits in byte 3 are then available for use as communication 
bits. 
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>—9,,_-$$ 


Function Specifies the value of the three-parms flag (byte 3, bit 0) of the SVC 
linkage. 


Format Oor 1. 
Default None. 


Remarks This bit should be 1 if there are more than one input parameter and 
more than one communication bit. If this bit is 1, all communication bits 
are in byte 5. 


SS SSS SS aaa aaa SSS SSS 


Function Specifies the value of the communication bit (byte 3, bit 1) of the SVC 
linkage. 


Format Oor 1. 
Default None. 


Remarks This bit is the only bit available in byte 3 for communication bits if the 
one-parm flag (byte 2 bit 7) is off. 


>—parnl <--> 


Function Specifies the value of parameter 1 (byte 3, bits 2 to 4). 
Format Numeric bit value. 


Default None. 
Na a ee ee 


Function Specifies the value of parameter 2 (byte 3, bits 5 to 7). 
Format Numeric bit value. 


Default None. 


porn 


Function Specifies the value of parameter 3 (bytes 4 and 5). 
Format Numeric bit value. 
Default None. 


Remarks If the pseudoparm 3 flag is on (byte 5, bit 0), byte 5 contains only com- 
munication bits (that is, does not contain a parameter 3). 
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Function Specifies the first two inline input variables. 

Format Variables separated by commas and enclosed in parentheses. 

Default None. 

Remarks For each variable specified, a 4-byte address constant is generated. 
Function Specifies the inline output variables. 

Format Variables separated by commas and enclosed in parentheses. 

Default None. 

Remarks For each variable specified, a fullword DC and RESTORE is generated. 


vane 


Function 


Format 
Default 


Remarks 


Specifies the inline parameters to be placed after byte 5 of the commu- 
nication bytes. 


Variables separated by commas and enclosed in parentheses. 
None. 


For each variable specified, a 4-byte address constant is generated. 
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ROUTE—Pass a PIU to the Explicit Route Control Component of 
Subarea Path Control 


The ROUTE macro passes a path information unit (PIU) to the explicit route control 
component of subarea path control (subarea node component). Destination routing 
is performed on the PIU on the basis of the information contained in its trans- 
mission header. 


Register 0 is not allowed for register parameters. 


Syntax 
caste ETE i ae (piu_register) 
name 


L_ 16B= (register MODE= FRO = 
ae 
, SUPV=NO 
, SUPV=——NO 
— 
, ERROR=SETCNZ 
, ERROR=——SETC 
SETNZ 
SETCNZ 
L RETCODE=(register)— 


a WORKR= (Lo rk_registe 


Parameters 


>—(piu_register) 


Function Specifies the register that points to the PIU to be routed. 

Format Absolute register notation. 

Default None. 

Remarks If SUPV=YES, neither register 1 nor register 6 is allowed. 
Register 3 is preferred. 


The register cannot be the same as that specified on the transmission 
group control block (TGB) or RETCODE keyword. 


On completion of the ROUTE function, the content of the register that 
specifies the PIU to be routed is set to 0. 
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i TGB= (regis ter ,MODE-—-FROM-)— 
7 TO 


Function When MODE=TO, the ROUTE macro expects the register to contain a 
pointer to the TGB that the PIU is to be sent over. When 
MODE=FROM, the ROUTE macro expects the register to contain a 
pointer to the TGB that the PIU arrived over. 


Format  (register.MODE=TO) or (register MODE=FROM). 

Default None. 

Remarks lf SUPV=YES, neither register 1 nor register 6 is allowed. 
Register 2 is preferred. 


Code MODE=TO when the subarea node already knows the trans- 
mission group that is to be used to route the PIU to its destination. 


Code MODE=FROM when the PIU destination is not known and the 
ROUTE macro must determine the destination based on the destination 
routing information in the transmission header of the PIU. 


By coding MODE=TO, the ROUTE macro infers that the PIU originated 
within NCP or within its boundary; thus, a null (0) TGB address is 
implied for the FROM keyword. 


The register cannot be the same as that specified on the PIU register 
keyword or the RETCODE keyword. 


, SUPV=NO 
Cae et 
Les 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 


Remarks If you code SUPV=YES, you must provide the address of an unused 
save area in register 6. 


» ERROR=SETCNZ | 
» ERROR=——SETC 

SETNZ 

SETCNZ 


Function Specifies whether the C latch, the Z latch, or both are to indicate an 
error. 


Format SETC, SETNZ, or SETCNZ. 
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Default 


Remarks 


ROUTE 


SETCNZ. 


Regardless of the keyword specified, the C latch is set to 1 if the PIU 
could not be routed; otherwise it is set to 0. The Z latch is set to O if the 
PIU could not be routed; otherwise it is set to 1. 


If the PIU cannot be routed, it is either released to the free-buffer pool or 
is placed on the system exception queue. 


S RETCODE=(regis ferye! 


Function 


Format 
Default 


Remarks 


Specifies the register to get the return code after execution of the 
ROUTE function. 


Register notation. 
Register 1. 


If the PIU could not be routed, the return code value is 1; otherwise, the 
return code value is 0. 


If the PIU cannot be routed, it is either released to the free-buffer pool or 
placed on the system exception queue. 


This keyword is valid only for SUPV=YES. 


The register cannot be the same as that specified on the PIU register 
keyword or the TGB keyword. 


L WORKR= (wo eer | 


Function 


Format 
Default 


Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. Specifying work registers makes execution of 
the macro more efficient. 


Register notation. 
No work registers. 
This keyword is valid only for SUPV=YES. 


You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. Do not use equated values. 
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ROUTEMAP—Access the Explicit Route to Virtual Route Mapping List 


Syntax 


The ROUTEMAP macro produces inline code that accesses the explicit route to 
virtual route mapping list (EML). The local network identification (LNID) and desti- 
nation subarea address field (DSAF) are used to find the correct row of the EML. 
The EML row is indexed with the virtual route number to determine the correct 
entry. Each EML entry is an explicit route mask that indicates the explicit route on 
which the virtual route number will flow. Either the entry is retrieved and put into 
the MASK variable, or the value from the MASK variable is stored into the entry, 
depending on the encoding of the FUNC keyword. 


For proper expansion of the ROUTEMAP macro, the NVT structure (XCXTNVT), 
the RMB structure (XCXTRMB), and the system equates (XCXTEQU) must be 
made available by the invoking module. Also, the invoking module must provide an 
EXTRN for external label CXTNVTO. 


Register 0 is not allowed for register parameters. 


p> — 7 ROUTEMAP—LNID= (lnidreg) ,—VRN=(vrnreg) ,—DSAF=(dsafreg) ,—MASK=(maskreg) , aa 


name 


>—WORKA= i bland ctecneesemon souhrvstnensSishi-i<hhthgeomscapcrmneresionsengnesseneer 


Parameters 


, FUNC=GET 
i FUNC= =e 
~Lpur 
Bs WORKR= Gkeredisten)= 


Note: No two keywords can specify the same register. 


»>—LNID=(lnidreg) —_—___-_-_-_-$§_ _____-———————————— 


Function Specifies the register that contains the local network identification. 
Format Byte register notation. 
Default None. 


Remarks Register contents are destroyed. 
>—VRN=(vrnreg) ,5——— 


Function Specifies a register containing the virtual route number that will be used 
in the virtual route to explicit route mapping. 


Format Byte register notation. 


Default None. 
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SNE cls 70 eg) 


Function Specifies a register that contains the destination subarea address of the 
virtual route. 


Format Register notation. 
Default None. 


Remarks The register contents are destroyed. 
»>—MASK=(naskreg) ,<—-—______ 


Function Specifies the register to be used to hold the explicit route mask. 
Format Register notation. 
Default None. 


Remarks A bit turned on in the mask indicates the corresponding explicit route. 
Bit O on indicates ER 0, bit 7 on indicates ER 7, and so forth, through 
bit 15. The explicit route mask is always a halfword, even though the 
EML entries may be 1-byte masks. If the EML entries are 1-byte masks 
and FUNC=PUT, only the high byte (bits 0 to 7) of the halfword is stored 
into the EML entry. If the EML entries are 1-byte masks and 
FUNC=GET, the high byte of the halfword explicit route mask is set to 
the EML entry's value and the low byte is set to 0. The register speci- 
fied must be an odd-numbered register. 


»>—WORKA= (workareg)-———£_____—_—__—__ > 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 


Default None. 


» FUNC=GET 
7 FUNC= a 
~Lopur 


Function Specifies whether the macro is to retrieve the explicit route mask from 
the EML or store the explicit route mask in the EML. 


Format Register notation. 
Default GET. 


Remarks FUNC=GET will set the Z-latch ON if the mask returned is 0, and will 
set the Z-latch OFF if the mask returned is not 0. The register specified 
must be an odd-numbered register. 
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,WORKR= (work_register) | 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks This keyword is required if FUNC=PUT. You can specify register 1, 3, 
5, or 7. Do not use equated symbols. 
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ROUTINE—Define the Entry Point for a Routine 


Syntax 


pe—name—ROUT INE 


Parameters 
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The ROUTINE macro defines the entry point for a routine in a structured process 
block created by a ROUTINE/RETURN pair. The routine is invoked by the 
PERFORM macro. Refer to “Structured Process Blocks” in NCP and SSP 
Customization Guide for more information. 


Before the ROUTINE macro executes, register 6 must point to a save area in the 
save area chain. The ROUTINE macro saves all designated registers in the save 
area and can update register 6 to point to the next save area in the chain. When 
the routine called by the ROUTINE macro is finished, use the RETURN macro to 

restore the saved registers and update register 6 with the pointer to the previous 

save area. 


You can change the save area pointer in register 6 by using the RESTORE macro 
to point at a save area different from the one set by the ROUTINE macro. 


Register 0 is not allowed for register parameters. 


se Ey Foren aa 
(rx,ry, INCL) 

Es RA=( ete 

,RA= (register) 

»AREA=YES 
— — 

Leyes 

»CSECT=NO 

ECT= = 
YES 


(+-register—_) 


SAVE= 
Lory, ry, INCL) 


Function Specifies the registers to be saved. (register,...) specifies the indi- 
vidual registers to be saved. (rx,ry,INCL) specifies the limits of a 
range of registers to be saved. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. 
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Default No registers are saved. . 


Remarks The value of the SAVE keyword on the ROUTINE macro is passed to 
the corresponding RETURN macro. 


Bans Lee 
,RA=(register) 


Function Specifies the register containing the return address. The register speci- 
fied must match the linkage register used by every PERFORM associ- 
ated with this ROUTINE macro. This return address is stored in the 
save area addressed by register 6 when the routine is entered. When 
the RETURN macro is executed, the return address in the save area is 
used to return control to the instruction following the completed 
PERFORM macro. 


Format Register notation. 
Default Register 7. 


Remarks lf the return address register is also coded in the SAVE keyword, the 
register contents will be duplicated in the save area field for that reg- 
ister. 


The return address register is generally the best choice for a return code 
or a returned parameter. 


The ROUTINE and PERFORM macros cannot detect that ROUTINE 
was invoked by a PERFORM macro that used a different linkage reg- 
ister. Incorrect operation will occur during execution if care is not taken 
when the network control program is assembled. 


» AREA=YES 
" AREA= “sa 
~Lyes 


Function Specifies whether register 6 is to be updated. AREA=YES indicates that 
register 6 is to be updated to point to the next save area in the chain 
after the registers are saved. AREA=NO indicates that register 6 is to 
remain pointing to the current save area after the registers are saved. 


Format YES or NO. 
Default YES. 


Remarks The value of the AREA keyword on the ROUTINE macro is passed to 
the corresponding RETURN macro. 


NO is for use only in the lowest-level routine that performs no other rou- 
tines. 


SAVE and RESTORE macros can be used within a routine if each 
AREA=YES keyword on a SAVE macro is balanced by an AREA=YES 
keyword coded on the corresponding RESTORE macro. 
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» CSECT=NO 
— — 
YES 


Function Specifies whether a CSECT statement is to be generated. CSECT=NO 
indicates that a CSECT statement is not generated. CSECT=YES indi- 
cates that a CSECT statement, using the name field, is generated. 


Format NOor YES. 
Default NO. 
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RSLVCAP—Get SSCP-NCP Session Capability Data 


Syntax 


The RSLVCAP macro, given a pointer to an SSCP-NCP session control block 
(SNP), returns 1 byte of the SNP's capability field. You indicate which of the 
4 capability bytes you want. 

RSLVCAP returns the capability byte in the byte register specified, as follows: 
CAPI Value SNP Capability Byte 


X'01' SNPSCAP1 
X'02' SNPSCAP2 
X'03' SNPSCAP3 
X'04' SNPSCAP4 


Register 6 must contain a valid save area pointer. Register 0 is not allowed. 


aca (Sra bag LVCAP—SNPP=(register) ,—CAPI=(byte_register) ,—CAPAB=(byte_register) ————————————» 


name 


Parameters 


,NCP=NO | 
cs 
, SUPV=NO 
— 


»>—SNPP= (register), > 


Function Specifies a register containing the pointer to the SSCP-NCP SNP. 
Format Register notation. 
Default None. 


Remarks Register 6 is not allowed. 
>—CAPI=(byte_register) ,—— 


Function Specifies a byte register containing the number of the capability byte 
you want. 


Format Byte register notation. 
Default None. 
Remarks The valid range for CAPI is 0 to 04. 


The register specified cannot be the same as the register specified for 
SNPP. 
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>—CAPAB= (byte_register) AA > 


Function Specifies a byte register that contains the appropriate byte of the SNP's 
capabilities. 


Format Byte register notation. 
Default None. 
Remarks The register specified may be the same as CAPI. 


The register may be the same as SNPP but the SNP address will be 
lost. 


» NCP=NO 
,NCP=——N 
= 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES specifies that inline linkage code is generated. 
NCP=NO specifies that an SCV is generated. 


Format YES or NO. 
Default NO. 
Remarks Specify this parameter only when SUPV=NO. 


, SUPV=NO 
— — 
~Lyes 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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RSLVDYN—Allocate or Deallocate a Network from the NVT 


The RSLVDYN macro allocates or deallocates a network from the network vector 
table (NVT). The desired network is identified by its network ID or local network 
identification (LNID). 


Note the following considerations: 


Syntax 


lf NTID=FIND, SUPV=NO, and NCP=NO are coded, register 1 is not valid. 


lf NTID=DFREE is coded, DSECT XCXTNVT is necessary for the proper 
expansion of the RSLVDYN macro. 


Register 6 must point to a save area. 
A different register must be used for each keyword. 


Register 0 is not allowed. 


re 7 BSLYDYN—-NTID= rnd »>—NVTE=(register) ,—RETC=(register )— > 
name 


DR 


,NETID=(register) 


, LNID=(register) 


»NCP=NO : 
aoe 

, SUPV=NO 
re 


Parameters 


>—NTID=——DAD : 
DFREE 
FIN 


Function Identifies which NETID operation is to be performed. 


NTID=FIND specifies that a NETID is to be found from the NVT. This 
keyword will be used only when NETID=(register) is specified on the 
RSLVDYN macro. 


Note: This function should only be used when finding the network for a 
station during XID2 negotiation time for leased subarea stations or 
during XID2 pre-negotiation time for switched subarea stations. This 
function increments the count of users for the found network. 
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NTID=DADD specifies that an available dynamic entry is to be allocated 
in the network vector table for the input NETID. This can only be used 
when NETID=(register is specified on the RSLVDYN macro. 


Note: This function should be used when allocating the network for a 
station during XID2 negotiation time for leased subarea stations or 
during XID2 pre-negotiation time for switched subarea stations. This 
function sets the count of users for the found network to 1. 


NTID=DFREE specifies that dynamic NETID entries from the NVT are to 
be freed when they are no longer needed. This should be used only 
when LNID=(register) is specified on the RSLVDYN macro. 


Note: This function should be used when deallocating the network for a 
station. This function decrements the count of users for the found 
network. The entry Is made available for reuse only if the count of users 
for the found network reaches 0. 


Format FIND, DADD, or DFREE. 
Default None. 
Remarks Only one NTID type can be specified at a time. 


You must code NVTE. It will be used to return a pointer to the found, 
allocated, or deallocated entry. 


You must code RETC. It will be used to indicate if the entry was found, 
allocated, or deallocated. 


If you code NTID=FIND, SUPV=NO, and NCP=NO, register 1 is not 
valid. 


>—NVTE=(register) ,—@£$@@—OoO i —-—-@-———H]LTT 


Function Specifies a register containing the pointer to the NVT entry. 
Format Absolute register notation. 
Default None. 


Remarks A full register is required. You must specify an odd-numbered register if 
NTID=DFREE. 


»—RETC= (register) ———_—_—________ 


Function Specifies a register that indicates: 


X'00' An in-use network ID that matched the input network ID was 
found in the NVT. This status is generated when NTID=FIND 
or NTID=DFREE. 


A new dynamic entry was allocated for the input network ID. 
This output status is generated when NTID=DADD. 


X'01' No in-use network ID that matched the input network ID was 
found in the NVT. This status is generated when NTID=FIND. 
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X'02' An in-use dynamic network ID that matched the input network 
ID was found in the NVT but was no longer usable because the 
number of stations using that dynamic network ID had already 
reached the maximum of 255. This status is generated when 
NTID=FIND. 


X'03' No new dynamic entry was available in the NVT. (All 255 are 
in use.) This status is generated when NTID=DADD. 


Format Absolute register notation. 
Default None. 


Remarks An odd-numbered register with byte specification O or 1 is required. 


L NETID=(register)— 


Function Specifies a register containing a pointer to the applicable NETID. 
Format Absolute register notation. 
Default None. 
Remarks A full register is required. 
If you code NTID=DFREE, NETID is not valid. 


Ls, LNID=(register)— 


Function Specifies a register containing the local network identification. 

Format Absolute register notation. 

Default None. 

Remarks An odd-numbered register with byte specification 0 or 1 is required. 
If you code NTID=FIND or NTID=DADD, LNID is not valid. 


»NCP=NO 
»NCP=——N | 
eS 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES indicates that the macros are to expanded 
inline. NCP=NO indicates that an SVC call is to be used. 


Format YES or NO. 
Default NO. 
Remarks If NCP=NO, Register 1 for NETID is not valid. 
Specify this parameter only when SUPV=NO is coded. 
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» SUPV=NO 
— — 
~Lyes 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in interrupt level. 


Format YES or NO. 
Default NO. 
Remarks lf SUPV=YES, you cannot specify register 1 for NETID. 
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RSLVNAD—Locate a Network Element Resource Control Block 


The RSLVNAD macro transforms a given element address either into the address 
of the resource control block for that element address or into the address of the 
resource vector table (RVT) entry for that address. RSLVNAD can also return the 
2-byte type field from the RVT if you code the TYPE keyword. If NCP is a gateway 
NCP, it may be necessary to specify the network in which the given address is 
valid by supplying the local network identification (LNID). If you do not specify 
LNID, the native network (LNID=0) is assumed. 


Register 0 is not allowed for register parameters. 


Syntax 


a LVNAD—(element_address_register )————_______ 
name 


L iveturnipegistenl= 


, LNID=(0) 
s LNID=(local_network_ID_regis see 


» ERROR=SETZ 


,ADDR=RVT 
—— —— 
Lyi 
aie 


’ rerince [Ete 
, SUPV=NO 
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Parameters 


»>—(element_address_register)@§$@@ — — —— i — —————_——"> 


Function Specifies the register containing the element address to be resolved. 
Format Register notation. 
Default None. 


Remarks If SUPV=YES, register 6 is not allowed. If SUPV=NO, register 1 is not 
allowed. 


Register 2 is standard. 


L (re ‘pn register) — 


Function Specifies the register in which the address is to be returned. 
Format Register notation. 
Default The element address register is also used as the return register. 


Remarks If SUPV=YES, register 6 is not allowed. If SUPV=NO, register 1 is not 
allowed. Register 3 Is standard. 


, LNID=(0) 
os LNID=( septal teed 


Function Specifies the register containing the local network identification of the 
network in which the specified element address is valid. 


Format Register notation. 
Default The native network (LNID=0) is assumed. 


Remarks Although the LNID keyword is a 1-byte value, you must specify a full 
register with the LNID in the low-order byte. The contents of the high- 
order byte are not read. 


The contents of the complete LNID register are preserved unless the 
register is used as an output register. 


If SUPV=YES, register 6 is not allowed. If SUPV=NO, register 1 is not 
allowed. Register 4 is standard. 


Function Either specifies the address to be given control or specifies whether the 
C latch, Z latch, or both are to indicate whether the supplied element 
address is valid. 
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Format Label notation, register notation, SETZNC, SETZ, or SETNC. 
Default SETZ. 


Remarks For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 
element address is not valid or to 0 if it is valid. For SETZNC or 
SETNC, the C latch is set to 0 if the element address is not valid or to 1 
if it is valid. 
SETZ gives the most efficient macro expansion. 


lf SUPV=YES, register 6 is not allowed. If SUPV=NO, register 1 is not 
allowed. 


Do not list this register as a work register in the WORKR keyword. 


» ADDR=RVT 
_— —— 
~Lpvt 


Function Specifies whether the address of the resource vector table entry or the 
address of the resource control block is to be returned (SUPV=NO only). 
If you specify ADDR=RESRCE, this macro returns the address of the 
resource control block (DVB, LCB, SCB, or LKB) pointed to by that RVT 


entry. 
If you specify ADDR=RVT, this macro returns the address of the RVT 
entry. 

Format RVT or RESRCE. 

Default RVT. 


Remarks If SUPV=YES, ADDR=RESRCE is not allowed. 


Laine Cv cients ee 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. Specifying such registers makes execution of 
the macro more efficient. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. Do not use equated values. 


Default No work registers. 


Remarks If SUPV=NO, this keyword is ignored. Do not use the register specified 
on the ERROR keyword as a work register. 
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ES TYPE=(resource_t wpejegisten= 


Function Specifies the register to return the resource type or the RVT flags field. 
Format Register notation. 
Default Type not returned. 
Remarks If SUPV=NO, register 1 is standard. 
If SUPV=YES, this keyword is not allowed. 
Register 1 is modified when this keyword is specified. 


» PRESNA=N 
— — 
Les 
Function For local subarea addresses, specifies whether a BSC or start-stop 
resource is valid. For PRESNA=YES, no checking is performed. For 


PRESNA=NO, a check is done to ensure that the network address is 
not a BSC or start-stop network address. 


Format YES or NO. 
Default NO. 


Remarks Checking is done to ensure that the network address is within the RVT, 
and that the network address refers to an SNA entry. 


» SUPV=NO 
= —— 
Lives 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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RSLVNET—Get Network Vector Table Data 


The RSLVNET macro furnishes information about a given network attached to a 
gateway NCP. The desired network is identified by its network ID, its local network 
identification (LNID), or a pointer to its entry in the network vector table (NVT). The 
XCXTNVT DSECT is necessary for the proper expansion of the RSLVNET macro. 
Also, if the input is NETID, register 6 must point to a usable save area and the 
issuing routine must issue an EXTRN for CXDNETID before issuing the macro. If 
the input is LNID, the issuing routine must issue an EXTRN for CXTNVTO. 


Register 0 is not allowed for register parameters. 


Syntax 
>> — 7 BSLYNET—I NPUT=(—-—LNID ,register) ,—WORKR= (register) -——_—_—@-—  ————_—> 
name = ETIO- 
NVTE 


»NCP=YES 
Ts 
L ERLIMIT= (register) | 
L uIsuUBA= leegisteny= 
L intD=(register)— | 
L LosuBa=(register)— | 
L NETID= (regisiery= 
L NSBMF= lpeqister) 
L NVTE=(register)— 


L QANP=(register)— 
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Parameters 


RSLVNET 


L RETN=(register)— 


L pwB= ienister)= 


L pveP=(register)— 


L pvt=(register)— 


L Shelpegister)— 


LL SALIMIT= (register) 


L sit (register)— 


L SUBME= fregisien)= 


L vit= (register)— 


»>—INPUT=( 


Function 


Format 


Default 


Remarks 


LNID ,register), 
NETIO 
NVTE 


Identifies the network about which information is to be supplied. 


(Keyword,register), where register is specified in absolute register 
notation. 


None. 
Only one input can be specified. 


lf INPUT=LNID, the specified register contains the local network identifi- 
cation. 


lf INPUT=NETID or NVTE, the specified register contains a pointer to 
the network ID or NVT entry. 


You must specify a full register if INPUT=NETID or NVTE and 1 byte of 
an odd-numbered register if INPUT=LNID. 


Except as discussed in the next paragraph, you can also specify an 
input register as an output register. 


When INPUT=LNID, the byte register containing the local network iden- 
tification is altered. When INPUT=NETID or NVTE, the input register is 
not altered. 
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When INPUT=NETID or LNID, code RETN. RETN indicates whether or 
not the given network ID appears in the network vector table: If 
INPUT=NETID, the information requested through other output parame- 
ters is valid only if the network is in use; if INPUT=LNID, the information 
requested through other output parameters is valid even if the network is 
not in use. 


>—WORKR= (register) -—_——_—_____—______—__—— > 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Absolute register notation. 
Default None. 
Remarks An odd-numbered full register is required. 


lf a single output is requested and that output is to be supplied in a full 
register, the work register may be used as an output register. 


lf multiple outputs are requested, the work register cannot be used as 
an output register. 


The input register cannot be used as a work register. 


»NCP=YES 
~ i 
~Lyes 
Function Specifies whether the macro is generated by user-written code or by 
NCP product code. 


NCP=YES specifies that this macro was called by an NCP user and 
inline code is generated. 


NCP=NO specifies that the call comes from a user-generated code and 
a SVC call is generated. 


Format YES or NO. 
Default YES. 
Remarks When NCP=NO, you cannot specify register 1 for NETID. 


i ERLIMIT= irecisten)= 


Function Specifies the register containing the highest allowable number of explicit 
routes supported (8 or 16) between subarea pairs in the specified 
network. 


Format Absolute register notation. 
Default None. 


Remarks An odd-numbered register with byte specification (0 or 1) is required. 
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L HISUBA=(register)— 


Function Specifies the register containing the higher 2 bytes of the subarea 
address of NCP in the specified network. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 


L LNID= ipegi ster) 


Function Specifies the register containing the local network identification. 
Format Absolute register notation. 
Default None. 


Remarks An odd-numbered register with byte specification (0 or 1) is required. 


L LosuBA=(register)— 


Function Specifies the register containing the lower 2 bytes of the subarea 
address of NCP in the specified network. 


Format Absolute register notation. 
Default None. 


Remarks This keyword is equivalent to the SA keyword except that it allows more 
accurate coding of keywords for new occurrences of this macro. If both 
SA and LOSUBA are coded, the SA keyword is ignored and a warning 
message is given. 


A full register is required. 


L NaPS=(register)— 


Function Specifies the register containing the 2-byte network address of the NCP 
physical services in the specified network. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 
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L NETID=(register)— 


Function Specifies the register containing a pointer to the applicable network ID. 
Format Absolute register notation. 
Default None. 


Remarks A full register is required. 


L NIBP= tneaieten)— 


Function Specifies the register containing a pointer to the applicable network 
interconnect control block. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 


L NSBMF=(register)— 


Function Specifies the register containing the applicable not-subarea mask (the 
complement of the subarea mask). 


Format Absolute register notation. 
Default None. 


Remarks An odd-numbered register with byte specification (0 or 1) is required. 


L ONVTE=(register)— 


Function Specifies the register containing a pointer to the applicable network 
vector table entry. 


Format Absolute register notation. 
Default None. 
Remarks A full register is required. 


L NVTFLGS= (register) = 


Function Specifies the register containing the NVT flag byte for the specified 
network. 


Format Absolute register notation. 
Default None. 


Remarks An odd-numbered register with byte specification (0 or 1) is required. 


318 NCP, SSP Customization Reference LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of |BM” RSLVNET 
Licensed Materials — Property of IBM 


L QANP= (register)= 


Function Specifies the register containing a pointer to the applicable queue 
anchor block for a network. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 


L RETN=(register)— 


Function If INPUT=NETID or LNID, specifies a register that indicates whether or 
not the given network ID appears in the network vector table. If the ID 
does appear, the specified byte register will contain X'00'; otherwise, 
the register will contain X'01'. 


Format Absolute register notation. 

Default None. 

Remarks An odd-numbered register with byte specification (0 or 1) is required. 
Specify RETN when INPUT=NETID or LNID. 
The RETN output is valid with the NETID input and LNID input. 


L RMB= (register) 


Function Specifies the register containing a pointer to the applicable route man- 
agement block. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 


L RVBP=(register)— 


Function Specifies the register containing a pointer to the applicable resource 
vector control block. 


Format Absolute register notation. 
Default None. 
Remarks A full register is required. 
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S RVT= (peuister)= 


Function Specifies the register containing a pointer to the highest element 
network address field (not to the first entry) in the applicable resource 
vector table. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 


L sa ineuister)= | 


Function Specifies the register containing the lower 2 bytes of the subarea 
address of NCP in the specified network. 


Format Absolute register notation. 
Default None: 


Remarks This keyword is equivalent to the LOSUBA keyword. For new occur- 
rences of this macro, code LOSUBA in place of SA. 


A full register is required. 


LL SALIMIT= (register)— 


Function Specifies the register containing the highest valid subarea address in the 
specified network. 


Format Register notation. 
Default None. 


Remarks A full register is required. 


L sit=(register)— 


Function Specifies the register containing a pointer to the applicable subarea 
index table. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 
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L suemr=(register)— 


Function Specifies the register containing the applicable subarea mask. 
Format Absolute register notation. 
Default None. 


Remarks An odd-numbered register with byte specification (0 or 1) is required. 


Le Vite (register) 


Function Specifies the register containing a pointer to the applicable virtual route 
subarea index table. 


Format Absolute register notation. 
Default None. 


Remarks A full register is required. 
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RSLVRID—Locate a BSC or Start-Stop Resource Control Block 


The RSLVRID macro converts a BSC or start-stop element address into either the 
address of the resource control block or the address of the resource vector table 
(RVT) entry corresponding to that element address. 


Register 0 is not allowed for register parameters. 


SUPV=YES Format (Generates Inline Code) 


Syntax 


a LVRID—(element_address_register) ,—SUPV=YES— a_i mooe 
name 


L appr-RvT— 


ona Pe torepenisee a 


Parameters 


»—(element_address_register) ,———_______ 


Function Specifies the register containing the element address to be resolved. 
Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 


>—SUPV=Y 3 OO 


Function Specifies that the issuer is running in an interrupt level. 
Format YES. 
Default NO. 
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RSLVRID 


Function 


Format 
Default 


Remarks 


Specifies either the address to be given control, or whether the C latch, 
Z latch, or both are to indicate whether the supplied element address is 
valid. 


Label notation, register notation, SETZNC, SETZ, or SETNC. 
lf SUPV=YES, no validity checking is done. There is no default. 
Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 


For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 
element address is not valid or to 0 if it is valid. For SETZNC or 
SETNC, the C latch is set to 0 if the element address is not valid or to 1 
if it is valid. 


SETZ gives the most efficient macro expansion. 


L ADDR-RVT—! 


Function Specifies whether the address of the RVT entry or the address of the 


Format 
Default 


resource control block is to be returned. 
RVT. 
RVT. 


L WORKR= epee ae 


Function Specifies a work register, the contents of which may be altered during 


Format 


Default 


execution of the macro. Specifying work registers makes the macro 
more efficient. 


You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. Do not use equated values. 


No work registers. 


Remarks This keyword is valid only when SUPV=YES. 
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SUPV=NO Format 


Syntax 


Scie ees ae LVRID—(element_address_register) a ere ea a PY =NQO——______—__—_____» 
name (return_register), 


Parameters 


, TYPE=(resource_type_byte) 


» ADDR=RVT 
, ADDR=——RESRCE 
i 


»—(element_address_register) ,———__W"#” 


Function Specifies the register containing the element address to be resolved. 
Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. 


ipseirmepeuteier) = 


Function Specifies the register in which the address is to be returned. 
Format Register notation. 
Default The element address register is assumed also to be the return register. 


Remarks Register 2 is not allowed. Register 3 is standard. 
»—SUPV=NOA>NANN No 


Function Specifies that the issuer is running in level 5. 
Format NO. 
Default NO. 
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, TYPE=(resource_type_byte) 


Function Specifies the register in which the resource type byte is to be returned. 
Format Byte register notation. 

Default No resource byte is returned. 

Remarks The high-order half (0) of register 1 is standard. 


Register 1 is modified when this keyword is specified. 


Function Specifies either the address to be given control, or whether the C latch, 
Z latch, or both are to indicate whether the supplied element address is 


valid. 
Format Label notation, register notation, SETZNC, SETZ, or SETNC. 
Default None. / 


Remarks Register 1 is not allowed. 


For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 
element address is not valid or to 0 if valid. For SETZNC or SETNC, 
the C latch is set to 0 if the element address is not valid or to 1 if valid. 


SETZ gives the most efficient macro expansion. 
If SUPV=NO, you must code this keyword. 


»ADDR=RVT 
— —— 
~Lavt 


Function Specifies whether the address of the RVT entry or the address of the 
resource control block is to be returned. 


Format RVT or RESRCE. 
Default RVT. 
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RSLVSNP—Locate an SSCP-NCP Session Control Block 


The RSLVSNP macro converts the following items into the address of the corre- 
sponding SSCP-NCP session control block (SNP): 


e SNP mask 
e SSCP name 
e Element address and virtual route vector table index (VVTI) pair. 


The address is either stored in the physical services block (PSB) or returned to the 
user, depending on how the the SNPADDR keyword is specified. If a mask was 
used as input, the mask bit corresponding to the SSCP is turned off, and the resi- 
dual mask is returned. 


Register 0 is not allowed for register parameters. Register 1 is not allowed for any 
keyword if SUPV=NO. Register 6 is not allowed for any keyword if SUPV=YES. 


If you specify NETADDR or ELEMADR, you must specify the VVTI keyword. 
MASK, SNPADDR, and CAPAB cannot share registers. 
The ELEMADR or NETADDR and VVTI registers must be different. 


You can use only one of the following input keywords on a given call: MASK, 
SSCPNME, NETADDR, or ELEMADR. 


Syntax 
a GTR ae LVSNP SK=(SNP_mask) — 
name SSCPNME=(SSCP_name_register) 
NETADDR=(SSCP_element_address) ,VVTI=(index_register) 
ELEMADR=(SSCP_element_address) ,VVTI=(index_register) 


, SNPADDR= (return_register) 
»MODE=SAMEVR 
pee a 
~Cgameve 


, CAPAB=(SSCP_capability) 


, ERROR=SETZ 


eA Pipers oe 
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Parameters 


RSLVSNP 


, SUPV=NO 
, SUPV=——NO 
Te 


>—MASK= (SNP_nas k) 


Function Specifies the register containing the SNP mask to be resolved. 


Format 


Default 


Absolute byte register notation. Must be the low-order half of an odd- 
numbered register. 


None. 


Remarks Register 1 is not allowed. 


The residual mask is returned in the same manner as the register. 


»>—SSCPNME=(SSCP_name_register )———A__ 


Function Specifies the register containing a pointer to the start of an SSCP name 


Format 
Default 


contained in storage. This name is compared to the SSCP name in the 
SNP. The SSCP name is left-justified, padded with trailing blanks, and 
halfword aligned. 


Register notation. 


None. 


>—NETADDR=(SSCP_e lement_address ) ,———-__ 


Function Specifies the register containing the element address to be resolved. 


Format 
Default 


Register notation. 


None. 


Remarks The keyword NETADDR is not recommended for new occurrences of 


this macro. 
lf SUPV=YES, register 3 is not allowed. 
Register 2 is standard. 


The register specified for NETADDR cannot be the same as that for the 
VVTI keyword. 


Do not code NETADDR if you code ELEMADR. If you do code both 
NETADDR and ELEMADR, NETADDR is ignored, and a warning 
message is issued during assembly. 
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>—ELEMADR=(SSCP_element_address ) ,——$_$________—__> 


Remarks ELEMADR is synonymous with NETADDR except that it allows more 
accurate coding of keywords for new occurrences of this macro. All 
constraints on registers for NETADDR apply to this keyword. If both 
NETADDR and ELEMADR are used, NETADDR is ignored, and a 
warning message is given. 


>—VVTI=(index_register) ———_—_—____ > 


Function Specifies the VVTI associated with the element address to be resolved. 
Format Register notation. 
Default None. 


Remarks If SUPV=YES, register 2 is not allowed. The VVTI keyword is required 
when NETADDR or ELEMADR is coded. 


= SNPADDR= (re Hin register) 


Function Specifies the register to return the SNP address. This register is set to 
O if the SNP is not resolved. 


Format Absolute register notation. 


Default If this keyword is omitted, the SNP address is placed into the 
PSBCSMPFP field of the PSB. 


Remarks If SUPV=YES, this keyword is required. 


»MODE=SAMEVR 
a mee 
~ Lsameve 
Function Specifies whether the SNP to be returned must be associated with the 


same virtual route as the specified VVT index or whether it can be on 
any virtual route ending in the subarea of the input VVT index. 


Format SAMEVR or ANYVR. 
Default __If this keyword is omitted, SAMEVR will be assumed. 
Remarks Specify this keyword only when the input is ELEMADR, VVTI. 
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» CAPAB=(SSCP_capability) 


Function Specifies the register in which the capability of the SSCP is to be 
returned (SNPSCAP1 field of the SNP). 


Format Byte register notation. 
Default None. 


Remarks The register specified for this keyword cannot be the same as those 
specified for SNPADDR or MASK. 


The low byte of register 1 (0(1)) is not allowed. 
Contents of the byte not specified for CAPAB will not be preserved. 


, ERROR=SETZ 


, ERROR=——(branch_address) 
SETZ 
SETNC 


Function Either specifies the address to be given control, or specifies whether the 
C latch, Z latch, or both are to indicate whether the supplied SSCP 
name or element/VVT index pair is valid. 


Format Label notation, register notation, SETZNC, SETZ, or SETNC. 
Default SETZ. 


Remarks For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 
element address is valid. For SETZNC or SETNC, the C latch is set to 
O if the element address is not valid or to 1 if the element address is 
valid. 


SETZ gives the most efficient macro expansion. 


Do not use this register for the WORKR keyword. 


a WORKR= (ee onicregiste =e 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. Specifying these registers makes this macro 
more efficient. 


Format You can use any or all of the following registers: 1, 2, 3, 4,5, and 7. 
You cannot use equated values. 


Default No work registers. 
Remarks If SUPV=NO, this keyword is ignored. 
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» SUPV=NO 
E SUPV= = 
Les 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in interrupt level. 


Format YES or NO. 
Default NO. 


Remarks If SUPV=NO, an EXIT instruction is generated. If SUPV=NO, register 1 
is not allowed, but the contents of register 1 are not destroyed. 
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RSLVSSCP—Convert an SNP Mask to a Network Address or VVT Index 


Syntax 


The RSLVSSCP macro converts a given mask or the highest order bit of an SNP 
mask to any one or combination of the following items for the corresponding SSCP: 


The high portion and the low portion of the subarea address 
The subarea address 

The element address 

The virtual route vector table (VVT) index. 


The corresponding bit in the mask register is turned off, and the resulting mask is 
returned. 


Register 0 is not allowed. Register 1 is not allowed if SUPV=NO; register 6 is not 
allowed if SUPV=YES. Do not specify the same register for more than one 
keyword. 


b> RSLVSSCP—-MASK= (SNP_mask) ,—ELEMADR- (register) ,—SSCPADR: (regis ter) ———___—+ 


name 


Parameters 


L wri- (eegister)= 
L HISUBA=(register)— 


L_ LosuBA=(register)— 


L WORKR= ae rk_registe = 
, SUPV=NO 
, SUPV=——NO 

— 


>—MASK= (SAP_nask) 


Function Specifies the register containing the SNP mask to be resolved. 


Format Byte register notation. Must be the low-order half of an odd-numbered 
register. 


Default None. 
Remarks Register 1 is not allowed. 


The residue mask is returned in the same manner as the register. 
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»—ELEMADR= (register) ,—_—_—___— > 


Function Specifies the register in which the element address of the SSCP is to be 
returned. 


Format Register notation. 
Default None. 


Remarks Avoid using ELEMADR or SSCPADR alone as output and code at least 
one other output keyword. 


»—SSCPADR= (register) —_—_—_—_—______ 


Function Specifies the register in which the address of the SSCP is to be 
returned. 


Format Register notation. 
Default None. 


Remarks This keyword is equivalent to ELEMADR except that ELEMADR allows 
more accurate and meaningful coding of keywords for new occurrences 
of this macro. SSCPADR is retained to minimize source changes 
required to the programs written before extended network addressing. If 
both SSCPADR and ELEMADR are specified, SSCPADR is ignored and 
a warning message is issued. 


U wri=(register)— 


Function Specifies the register for the virtual route vector table index (VVTI) asso- 
ciated with the SSCP requested. 


Format Register notation. 


Default None. 


L HISUBA= iregister\— 


Function Specifies the register to return the high portion of the subarea address 
of the SSCP. This part of the address is right-justified when it is 
returned. 


Format Register notation. 


Default None. 
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L- LOSUBA= (register) 


Function Specifies the register to return the low halfword of the subarea address 
of the SSCP. The address is right-justified when it is returned. 


Format Register notation. 


Default None. 


—_ Ct voneregis te | 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. Specifying this keyword makes this macro more 
efficient. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. Equated values cannot be used. 


Default No work registers. 
Remarks If SUPV=NO, this keyword is ignored. 


, SUPV=NO 
-— cod 
Lys 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in interrupt level. 


Format YES or NO. 
Default NO. 


Remarks If SUPV=NO, an exit instruction is generated. 
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RSLVTGB—Locate an Outbound Transmission Group Control Block 


The RSLVTGB macro converts either a subarea address (SA) and transmission 
group number (TGN) or a subarea address and an explicit route number (ERN) into 
a pointer to the corresponding transmission group control block (TGB) used for out- 
bound routing. In a gateway environment, the identifier of the network to be 
searched must be specified. Unless you specify local network identification (LNID), 
the native network is assumed. 


Register 0 is not allowed for register parameters. 


Syntax 
a SI LVTGB—TGB=(register) ,—SA=(register) at Eh Os an 6 
name ERN=(register) 


, LNID=(0) 
es 


» ERROR=—7—SETNC 
SETZ 
SETZNC 


, SUPV=NO 
E SUPV= “eet 
~Lyes 
q WORKR= (446 ores 


Parameters 


>—TGB=(register) , 


Function Specifies the register in which the TGB address is to be returned. 
Format Absolute register notation. 
Default None. 


Remarks The register cannot be the same as the register specified on the SA, 
TGN, ERN, or WORKR keyword. 


If SUPV=YES, register 6 is not allowed. 
Register 7 is standard. 


A value of 0 is returned if the TGB address could not be returned. 
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»>—SA=(register) , 


Function Specifies the register containing the network subarea address to be 
resolved. The subarea address is right-justified and not shifted. 


Format Absolute register notation. 
Default None. 


Remarks The register cannot be the same as the register specified on the TGN, 
ERN, LNID, WORKR, or TGB keyword. 


lf SUPV=YES, register 6 is not allowed. If SUPV=NO, register 1 is not 
allowed. Register 2 is standard. 


>—_Tan= ( 3 . 
ERN=(register) 


Function Specifies the register containing the TGN or ERN to be resolved. 
Format Absolute register notation. 

Default None. 

Remarks You can code the TGN or ERN keyword, but not both. 


The register cannot be the same as the register specified on the SA, 
WORKR, LNID, or TGB keyword. 


TGN and ERN cannot both be blank. 


lf SUPV=YES, register 6 is not allowed. If SUPV=NO, register 1 is not 
allowed. Register 3 is standard. 


amore) 
,LNID=(register) 
Function Specifies the byte register containing the local network identification to 


be used to resolve the TGB. 


Format Byte register notation. It must be in the low-order half of an odd- 
numbered register. 


Default Native network, LNID=0. 
Remarks If SUPV=NO, register 1 is not allowed. 


The register used cannot be the same as the register specified on the 
TGN, ERN, WORKR, TGB, or SA keyword. 
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, ERROR=—7—SETNC 
b ETZ 
SETZNC 


Function 


Format 
Default 


Remarks 


Specifies whether the C latch, the Z latch, or both are to indicate 
whether the requested resolution can be done. 


SETZ, SETNC, or SETZNC. 
None. 


For all three specifications, the Z latch is set to 1 if the resolution cannot 
be done or to 0 if the resolution can be done. The C latch is set to 0 if 
the resolution cannot be done or to 1 if the resolution can be done. 


For SUPV=NO, the C and Z latches are set as above whether the 
keyword is coded or not. For SUPV=YES, latch settings are indetermi- 
nate if ERROR is not coded. 


, SUPV=NO 
ns ee 
Lys 


Function 


Format 
Default 


Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


YES or NO. 
NO. 


L WORKR= Scorers Me 


Function 


Format 


Default 


Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. 


You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. 


No work registers. 
This keyword is valid only with SUPV=YES. 


The registers cannot be the same as the registers specified on the TGB, 
ERN, LNID, SA, or TGN keyword. 
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RSLVVVTI—Get Virtual Route Control Block Data 


The RSLVVVTI macro indexes the virtual route vector table (VVT) to get either the 
address of a virtual route control block (VRB) or the low- or high-order portion of 
the subarea address of the other end of the virtual route. If the VVT index is not 
valid or if the VRB pointed to by the VVT is not assigned to a virtual route, the VRB 
address or the portion of the subarea address returned is 0, and the Z latch is set. 


This macro generates inline code. 


The VVT DSECT, XCXTVVT, must be available and addressability must be estab- 
lished to the VVT using EXTRN CXTVVT. If SUBAREA, LOSUBA, or HISUBA is to 
be returned, the VRB DSECT, XCXTVRB must be available. 


Note that all registers must be different. Register 0 is not allowed. 


Syntax 


Pe SLT WE (register), VRBP=(register) 

name SUBAREA= (register) 
LOSUBA=(register) 
HISUBA=(register) 
LOSUBA=(register) ,HISUBA=(register) 
SUBAREA= (register) ,HISUBA=(register) 


»—WREGA= (register) 


L WREGB=(register)— 


Parameters 


>—VVTI=(register) <——_@£-@——————— ———— > 


Function Specifies the register containing the VVT index (VVTI). 
Format Register notation. 


Default None. 


VRBP=(register) 
SUBAREA= (register) 
LOSUBA=(register) 
HISUBA= (register) 
LOSUBA= (register) ,HISUBA=(register) 
SUBAREA=(register) ,HISUBA=(register) 


Function Specifies the register in which either the VRB address or the other-end 
SUBAREA, LOSUBA, or HISUBA of the virtual route is to be returned. 


Format Register notation. 


Default None. 
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Remarks lf the VVTI is not valid or if the VRB is not assigned, the VRB address 
or SUBAREA, LOSUBA, or HISUBA returned will be 0. 


The registers must not be the same as the register specified on the 
VVTI keyword. 


HISUBA returns the high-order portion of the other end of the virtual 
route. 


Do not specify both LOSUBA and SUBAREA. They each return the 
low-order portion of the subarea address of the other end of the virtual 
route. LOSUBA is preferred. 


»>—WREGA= (register) ——_—____ 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks The register must not be the same as the register specified on the VVTI, 
VRBP, SUBAREA, LOSUBA, or HISUBA keywords. 


The code will be more efficient if you use an odd-numbered register. 


L WREGB=(register)— 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 


Remarks If you do not specify WREGB but do specify VRBP, the contents of the 
register specified by the VVTI keyword are destroyed. 


If you do not specify WREGB but do specify only the SUBAREA, 
LOSUBA, or HISUBA keyword, the contents of the register specified by 
the VVTI keyword are destroyed. 


If you do not specify WREGB but you specify HISUBA in addition to 
SUBAREA or LOSUBA, the contents of the register specified by the 
VVTI keyword are not destroyed. 


The register must not be the same as the register specified on the VVTI, 
VRBP, SUBAREA, LOSUBA, HISUBA, or WREGA keywords. 
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SAVE—Store Registers 


The SAVE macro stores the specified registers in the save area pointed to by reg- 

ister 6 and updates register 6 to point to the next save area in the save area chain. 
When you use the SAVE macro with the optional LINK macro RA=B keyword, you 

can save the return address in the previous save area. 


The SAVE macro does not save registers designated as work registers on the 
WORKER keyword. Use this function for macros that allow you to specify work reg- 
isters that do not need to be saved. 


Register 0 is not allowed for register parameters. 


Syntax 
sa aa ETE Ws 
name 


Foe 
(rx ,ry, INCL) 
, AREA=NO 
, AREA=——NO 
— 
L WORKR= ae pore Ae 


= ple (register) 


Parameters 
Bicone 
(rx,ry, INCL) 


Function Specifies the registers to be saved. (register) specifies the individual 


registers to be saved. (rx,ry,INCL) specifies a range of registers to be 
saved. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. 


Default No registers are saved. 


Remarks If you specify the (register) format, and you specify the same register for 
WORKR, the register will not be saved. 


If you specify with (x,ry, INCL), WORKR=(register) is not valid. 
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» AREA=NO 
E AREA= a 
Les 


Function 


Format 
Default 


Specifies whether register 6 is to be updated. YES specifies that reg- 
ister 6 is to be updated to point to the next save area in the chain after 
the registers are saved. NO specifies that register 6 is not to be 
updated. 


YES or NO. 
NO. 


L WORKR= fae Oe 


Function 


Format 


Default 
Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. 


You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. You cannot use label register values. 


No work registers; all registers specified in the first keyword are saved. 


If you specify a register in the first parameter with the (register,...) format 
and you specify the same register for WORKR, the contents of the reg- 
ister are not saved. If you specify a register in the first parameter with 
(rx,ry, INCL), the WORKR keyword is not valid. 


Le Whe (registenl= 


Function 


Format 
Default 


Specifies the register that contains the return address. The contents of 
this register are stored at offset 8 in the save area pointed to by register 
6. This register is then available for use by the RESTORE macro. If 
this register is also in the first keyword position, it will be saved there. 


You can specify register 1, 2, 3, 4, 5, or 7. 


No register saved. 
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SAVEAREA—Create Inline Storage for Registers 


Syntax 


p>>—name—SAV EAREA—SAVE=7— (Yregis terL)—-,-savearea_nane 


Parameters 


The SAVEAREA macro uses load address instructions to create inline storage for 
your registers. Use the SAVEAREA macro when you do not have register 6 
pointing to a regular save area. 


The SAVEAREA macro generates the following: 
e An 8-byte chain field for forward and backward chaining of the save area 


e A load address (LA) instruction for each register to be saved when this save 
area is referred to a CALL macro 


e A branch to the next sequential instruction after the CALL macro that last 
referred to this save area 


e A global set symbol telling the supervisor which registers are to be saved in this 
save area. 


When a CALL macro is issued, the supervisor stores the appropriate register in 
each LA instruction. It then stores the address of the next sequential instruction 
after the CALL macro in the last instruction generated by this SAVEAREA macro. 
When a subroutine returns control to the calling program, execution begins at the 
first LA instruction in the save area generated by the SAVEAREA macro. Exe- 
cution proceeds through each LA instruction until all specified registers are 
restored. At this point the program branches to the mainline instruction, and normal 
processing continues. 


(rx,rn, INCL) 


r>—SAVE=- (-tregister)—, 
(rx,rn, INCL) 


Function Specifies the registers to be saved. 
Format Absolute notation. 
Default None. 


Remarks If a series of registers is to be saved, rx and rn specify the limits of the 
range of registers. The range is specified in ascending sequence, and 
the symbol INCL is coded as the third parameter to specify a series. 
Register 1 cannot be saved. If a random grouping of registers is to be 
saved, specify each register. 


Register 0 is not allowed. 
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<< dVeOTed 1K eee eS SS SS ed 


Function Specifies the name of the save area, and is identical to the name speci- 
fied on the SAVE keyword of the corresponding CALL macro. 


Format Any symbol with up to 7 characters. 


Default None. 
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SAVESQ—Record PIU Sequence Numbers when the Session Trace Is 
Active 


The SAVESQ macro is used to record path information unit (PIU) sequence 
numbers when the session trace is active. The numbers are stored in the specified 
control block: DVB, CUB, BSB, or NIX. 


Register 0 is not allowed for register parameters. 


Syntax 
p>—name—SAVESQ—RESTYP=——BSB , —RESREG=—— (register) , —PIUREG=-——(register) aS 
Ee “eymboly— TSeymbgty 
DVB 
NIX 
»>—WORK= (register | »—— INOUT= 2 aaa a I 
af dahil | ~Lout 
Oe hee I 
symbol 
Parameters 


>—RESTYP=——BSB ; 
CUB 
DVB 


NIX 


Function Specifies the type of control block into which the sequence numbers are 
to be stored. 


Format DVB, CUB, BSB, or NIX only. 
Default None. 
Remarks Include the DSECT for the specified control block, as follows: 


Control Block Macro 


DVB XCXTDVB 
CUB XXCXTCUB 
BSB XCXTBSB 
NIX XCXTNIX 


»>—RESREG=——(register) : 
“CU (symbot) 


Function Specifies the register containing the address of the resource control 
block to be updated. 


Format Register or symbol notation. You can specify register 1, 2, 3, 4, 5, or 7. 
Default None. 


Remarks If CUB is specified in RESTYP, a second work register must be speci- 
fied. 


The register must not be the same as that specified for any other 
keyword. 
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»>—P IUREG= register : 


Function Specifies the register containing the address of the PIU being traced. 
Format Register or symbol notation. You can specify register 1, 2, 3, 4, 5, or 7. 
Default None. 


Remarks The register must not be the same as that specified for any other 
keyword. 


p>—WORK= (register>——___,- ; 
si »sregister | 
(s ymbol>———-) 
»symbol 


Function Specifies one or more registers, the contents of which may be altered 
during execution of the macro. 


Format Register or symbol notation. For the first keyword value, you can 
specify register 1, 3, 5, or 7. For the second keyword value, you can 
specify register 1, 2, 3, 4, 5, or 7. 


Default None. 


Remarks lf you specify RESTYP=CUB, you must code the second keyword value; 
otherwise it is ignored. 


The register must not be the same as that specified for any other 
keyword. 


oe a (aaa ea 
OUT 


Function Specifies whether the PIU being traced is an incoming or outgoing PIU. 
Format _ IN if the PIU is incoming; OUT if the PIU is outgoing. 


Default None. 
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SCAN—Get the Address of the Next Buffer in a Chain 


Syntax 


The SCAN macro returns the address of the buffer following a specified buffer in a 
buffer chain. This macro can also be used to determine whether the specified 
buffer is the last one in a chain of buffers. The Z latch is set to 1 if the buffer is 
last and to 0 if it is not last; the C latch is set conversely. 


The SCAN macro always expands inline. 


Register 0 is not allowed for register parameters. 


sca a 
name 


Parameters 


L (scan_buffer_oddress)— 


, LAST=—— (branch_address) 
tn 


»>—(current_buffer_address )———_____ > 


Function Specifies the register containing the currently accessed buffer address. 
Format Register notation. 


Default None. 


Function Specifies a register to receive the address of the next buffer in the 
chain. 


Format Register notation. 
Default The address of the next buffer is returned in the current-buffer register. 


Remarks The register is set to 0 if the current buffer is the last in the chain. 
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, LAST=—— (branch_address) 
ic ETZ 


Function Either specifies the address to be given control, or specifies whether the 
C latch, Z latch, or both are to indicate whether the current buffer is the 
last buffer in the chain. 


Format Register notation, label notation, SETZNC, SETZ, or SETNC. 
Default The next instruction after the macro is given control. 


Remarks For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 
positional buffer is the last buffer in the element or to 0 if it is not the 
last. For SETZNC or SETNC, the C latch is set to 0 if the current buffer 
is the last buffer in the chain or to 1 if it is not the last. 
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SDB—Build IBM-Required UACB Fields 


The SDB macro builds the IBM-required user adapter control block (UACB) fields. 
This macro must immediately follow each UACB in the control block assembly 
source code. 


Syntax 
>> —__7 SDB LINADDR= Line_address——,—GCBNAME=group_control_block_name ,——_—__—~ 
name Lyon pa 


>—CNTLBLK=control_block_name 
r-, CHANLNK=NO 
: CHAN —— 
» TIMERCH=YES 
= Te 
»RCVLEG=N 
: RCV —— 


Parameters 


>—LI NADDR=——1 ine_address——, 
NON pe 


Function /ine address specifies the line address associated with this UACB. 
NONE indicates that the UACB is not associated with a physical line. 


Format Absolute notation. 


Default None. 


>—GCBNAME=group_control_block_nane ,——_-___ 


Function Specifies the group control block (GCB) associated with this UACB. 
The GCBNAME must match the symbol for a GROUP definition state- 
ment. 


Format Any symbol. 


Default None. 
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>—CNTLBLK=control_block_nane———_————_——_—__ cm —-_—_—————“7 


Function Specifies the name of the UACB control block generated by this macro. 
The name must be unique for each SDB macro used. NCP uses this 
macro for timer chaining purposes. 


Format Any valid symbol. 
Default None. 


» CHANLNK=NO 
: CHANLNK= — 
Ly ES 


Function Specifies whether this UACB is for channel or link operations. 
CHANLNK=YES means the UACEB is for a channel, while 
CHANLNK=NO means the UACEB Is for a link. 


Format YES or NO. 
Default NO. 


» TIMERCH=YES 
» TIMERCH=——N 
ie 


Function Specifies whether this UACB is to be included in the level 3 timer chain. 
lf TIMERCH=NO, this particular UACB will not be available for timer- 
dependent operations and will not be included in the level 3 timer chain. 


Format YES or NO. 
Default YES. 


Remarks You can specify TIMERCH=NO for virtual resources that will never be 
associated with timer-dependent events (such as NPSI virtual circuits) to 
obtain a significant performance improvement. However, specifying 
TIMERCH=NO when the resource does have timer-dependent events 
will lead to a resource failure. 


» RCVLEG=N 
or =e 
Lys 
Function Specifies whether this line address is for the receive leg of a duplex line. 


Format YES or NO. 
Default NO. 
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SETEVNTL—Create a Link between an Event and a Processing Routine 


The SETEVNTL macro establishes the linkage between an event and a processing 
routine to be activated upon completion of the event. This macro is never used by 
level 5 code. 


Register 0 is not allowed for register parameters. 


Syntax 


cca ee hae ETEVNT L—ECB-——ecb_address—————_7~4- ROUT INE=rout ine_address——__-____LL__ 
name (register) 
, BUFFER 


Bissidliadl 
» SUPV=YES 


Parameters 
be aE CB eC s0d0 659 ye 


(registery—__) 
»BUFFER 


Function Specifies the address of the event control block. 
Format Register or label notation. 

Default None. 

Remarks Neither register 1 nor register 6 is allowed. 


If the event control block (ECB) is not defined in storage but is part of a 
block control unit (BCU), you must use register notation and specify 
BUFFER. The register must point to the beginning of the first buffer of 
the BCU. 


»>—ROUTINE=routine_address——@ > 


Function Specifies the address of the supervisor program that is to receive control 
on event completion. 


Format Register or label notation. 
Default None. 


Remarks Neither register 1 nor register 6 is allowed. 


| 
, SUPV=YES 
Function Specifies that the issuer is running in an interrupt level. 


Format YES. 
Default YES. 
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SETIME—Schedule an Interrupt and a Task for a Time Interval 


The SETIME macro schedules an interrupt for a specified time interval and sched- 
ules a specified task at the expiration of the timer interval. 


Register 0 is not allowed for register parameters. 


Syntax 
cae Es Ga ETIME—interval, ecb_address_______ »_qcb_address 
name ( register ———r~) 
, BUFFER 
Parameters 


»>—interval, 


Function Specifies an integral number of seconds for the time interval. 
Format Absolute, label, or register notation. 

Default None. 

Remarks This interval cannot exceed 5400 seconds (1/16 of a day). 


Register 1 is not allowed. 


OCD _ AER OS Sk 


(register>— ss) 
,BUFFER 


Function Specifies the event control block (ECB) to be used by the supervisor for 
the duration of the interval. 


Format Register or label notation. 

Default None. 

Remarks A separate ECB is specified for each unexpired interval to be scheduled. 
Register 1 is not allowed. 


lf the ECB is not defined in storage but is part of a block control unit 
(BCU), you must use register notation, and you must specify BUFFER. 
The register must point to the beginning of the first buffer of the BCU. 


»>—qcb_address———___________———————— ——* 


Function Specifies the address of the input or pseudo-input queue control block 
governing the task to be started when the interval elapses. 


Format Register or label notation. 
Default None. 


Remarks Register 1 is not allowed. 
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SETLATO—Set the Link Activity Time-Out Field in the CCB 


The SETLATO macro is used to set up the link activity time-out (LATO) field in the 
character control block (CCB) for secondary SDLC links. This macro is used in 
program levels 2 and 3 and requires that the XCXTDDB, XCXTACB, and 
XCXTLGT DSECTs be present, and that addressability be established. 


Register 0 is not allowed for register parameters. 


Syntax 
>> —___ SETLATO—(acb_register) pra Ot regioter aWOnk heltste) 
name (0) 


Parameters 


»—(acb_register) , 


Function Specifies the register containing the address of the adapter control block 
(ACB). 


Format Register notation. 
Default None. 


Remarks Addressability to the ACB must be set up by the program invoking the 
macro. 


»—_{lgt_register) , (work_register) 
(0) 


Function Specifies whether the contents of the LATO field should be set to 0, or if 
the system-generated LATO field from the line group table (LGT) should 
be copied to the CCB. 


Format Register notation. 

Default None. 

Remarks Code 0 if the contents of the LATO field should be set to 0. 
Igt reg is the register containing the address of the LGT. 


work reg is any register (other than acb reg or 0) that can be used as a 
work register (coded only if /gt reg is not equal to 0). 


Addressability to the LGT must be set up by the invoking program only if 
Igt reg is not equal to 0. 


The inline code generated by this macro is either code to store a 
halfword of zeros in CCBLATO if /gt reg is equal to 0, or code to move 
LGTLATO into CCBLATO. 
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SETPRI—Set the Priority of an Element in a Queue 


The SETPRI macro sets the priority of any element, except a queue control block 
(QCB), that can be placed on a queue. The priority is set in the ECBCSTAT field 
of the element's event control block (ECB). You must provide a save area that can 
be overwritten, and the QCB DSECT (XXQCB) must be available. SETPRI 
requires that the XSYSEQU macro be invoked. 


Register 0 is not allowed for register parameters. 


Note: This macro can be executed by interrupt-level code only. 


Syntax 
as Sa ics ALL »—(element_pointer_register) ,—PRI=p +—CONT= NOs FIDTVPE=n ~~ 
name LF IX YES 
PIU 


»>—WORKR= C* forkregister—) 


| 
, SUPV=YES 


Parameters 


ALL ; 
LFIX 
PIU 


Function Specifies the keyword to be used. 


If you specify the PIU keyword, the priority of the specified path informa- 
tion unit (PIU) is set to the designated priority. If the PIU has been 
queued, its priority is not set. 


lf you specify the FIX keyword, the priority of the first element on the 
specified queue is set to the highest priority (15). 


If you specify the ALL keyword, the priority of all elements on the speci- 
fied queue is set to the designated priority. 


Format =~ PIU, FIX, or ALL. 
Default None. 


Remarks Execution of this macro is terminated when a QCB is found on the 
queue, regardless of the keyword. 


»>—(element_pointer_register) ee ee a el Se 


Function Specifies the address of a PIU or a QCB. 
Format Register notation. 


Default None. 
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Remarks If you specify the FIX or ALL keyword, you must use a QCB address. If 
you specify the PIU keyword, you must use a PIU address. 


Register 3 is standard. Neither register 1 nor register 6 is allowed. 


The register content is not altered. 


PRE 9 , —— — 


Function Specifies the priority value to be set in the element's ECB. 
Format Absolute or label notation. You can use any value from 0 to 15. 
Default None. 


Remarks If the element has not been enqueued, the priority value set by SETPRI 
is used when the element is enqueued with PRI=YES on the ENQUE 
macro instruction. 


You cannot specify both the FIX keyword and the PRI keyword. 


>—CONT=-NO—-, 
yEs— 


Function Specifies whether the queue is a contention queue (one that can be 
manipulated simultaneously by two or more interrupt levels). 


Format YES or NO. 
Default None. 


Remarks If CONT=YES, level 3 interrupts are disabled. This keyword is ignored 
when PIU option is used. 


Sl) a SSS SSS SSS SS Se 


Function Specifies the FID type of the PIU. 
Format 0, 1, 2, 3, or 4. Only absolute values may be used. 
Default None. 


Remarks When you specify the FIX or ALL keyword, this keyword is ignored. 


>—WORKR= (Sl oreregister ~— OO 


Function Specifies one or more work registers, the contents of which may be 
altered during execution of the macro. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, and 7. 
Do not use equated values. 


Default No work registers. 
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— 

» SUPV=YES 

Function Specifies that the issuer is running in an interrupt level. 
Format YES. 


Default YES. 


Remarks This parameter is ignored when the PIU keyword is coded. 
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SETRP1C—Set the System Response Phase to Phase 1 


The SETRP1C macro sets the system response phase to phase 1 if it is currently 
phase 0. If the system response phase is not phase 0, no change is made. 


Include and address the block control unit (BCU) DSECT (XXCXTBCU). 


Syntax 
re —___SEIRPIC 
name 
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SETTGB—Control the Activation of a Transmission Group 


The SETTGB macro controls the process of activating and deactivating a specified 
transmission group. 


Register 0 is not allowed for register parameters. 


Syntax 
r>—7___1—SETT@B— (tgb_address_register) ,—COMMAND= EROP ~—— 
name ERINOP 
DLCOP 


(DLCNOTOP, (reason_register) ) 
>—DLCB=(register) 


—- Pe orkcreqiste =< 
, SUPV=NO 
, SUPV=——NO 

— 


Parameters 


»—(tgb_address_register), 


Function Specifies the register containing the address of the transmission group 
control block (TGB). 


Format Register notation. 
Default None. 
Remarks If SUPV=NO, register 1 is not allowed. 
lf SUPV=YES, register 2 is standard and register 6 is not allowed. 


The register must not be the same as the register specified on the 
DLCB or WORKR keywords. 


ERINOP ° 
DLCOP 


eee $$ 
(DLCNOTOP, (reason_register) ) 


Function Specifies the event that will take place and causes an action to be taken 
by the corresponding transmission group. 


EROP indicates that the explicit route manager function has identified all 


NCP operative routes in the transmission group's network to the adja- 
cent node. 


ERINOP indicates that the explicit route manager function has com- 
pleted all processing associated with terminating the operative state for 
all explicit routes associated with the specified TGB. 
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DLCOP indicates that the data link control (DLC) currently associated 
with the specified TGB is operational (capable of exchanging normal 
data traffic with the adjoining node). 


(DLCNOTOP, (reason register) indicates that the DLC currently associ- 
ated with the specified TGB is no longer operational (incapable of 
exchanging normal data traffic with the adjoining node). (reason 
register) contains the reason code for the DLC going inoperative. The 
reason code is saved to make it accessible through the TESTTGB 
macro. 


EROP and ERINOP commands must not be issued if the TGB is ona 
system queue, for example, RCQ. 


Format EROP, ERINOP, DLCOP, (DLCNOTOP,(reason register)). The reason 
register must be a byte register. 


Default None. 


Remarks If SUPV=NO and COMMAND=(DLCNOTOP,(reason register)) are speci- 
fied, the contents of register 1(0) are not preserved by this macro. 


Register 1(0) is standard for (reason register). 
»>—DLCB=(register) — —@@ ——_ > 


Function Specifies the data link control block associated with the DLC event that 
will take place. 


Format Register notation. 
Default None. 


Remarks This keyword is required when COMMAND=DLCOP or 
(DLCNOTOP, (reason register\); you cannot code it when 
COMMAND=EROP or ERINOP is coded. 


lf SUPV=NO, register 1 is not allowed. 
lf SUPV=YES, register 3 is standard and register 6 is not allowed. 


The register must not be the same as the register specified for the TGB 
address register or on the WORKR keyword. 


a WORKR= (Lo een ee 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default No work register. 
Remarks This keyword is valid only with SUPV=YES. 


The register must not be the same as the register specified for the TGB 
address register or on the DLCB keyword. 


You can code up to five of the following registers: 1, 2, 3, 4, 5, and 7. 
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, SUPV=NO | 
, SUPV=——NO 
= 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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SETXTRN—Control EXTRN and WXTRN Assembler Statements 


The SETXTRN macro controls the generation of EXTRN and WXTRN assembler 
statements. An EXTRN statement is generated only on the first occurrence of a 
given reference in a SETXTRN macro. For all other occurrences in the same 
assembly, the EXTRN or WXTRN statement is omitted. 


Syntax 
es Se (eg ETXTRN—(—Yexternal_re AE sae ede oe 


name 
,GEN=YES 
—s 
, TYPE=E 
———— 


Parameters 


sf Sectemal re Sper ei ya 


Function Specifies the labels that are external references. If appropriate, the 
macro generates an EXTRN or WXTRN statement. 


Format One or several external references. The sublist form is allowed. 
Default None. Specify at least one reference. 


Remarks Specify a maximum of 399 different external references for each 
assembly run. 


»GEN=YES 
= ee 
Les 


Function YES specifies that an EXTRN or WXTRN statement will be generated at 
the first occurrence of a reference on a SETXTRN macro in the 


assembly. 
Format YES or NO. 
Default YES. 


Remarks Use SETXTRN with GEN=NO for references that are entry points in the 
actual module. Code the ENTRY statements separately. Succeeding 
SETXTRN macros with GEN=YES do not generate EXTRN or WXTRN 
statements for these entry points. 
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, TYPE=E | 
a 
Function Specifies the type of statement to be generated. TYPE=E specifies that 


an EXTRN statement will be generated; TYPE=W specifies that a 
WXTRN statement will be generated. 


Format E or W. 


Default’ €E. 


Remarks Use SETXTRN with TYPE=E for references to entry points that are 
always included. The link-edit will fail if the entry point cannot be found. 
Use SETXTRN with TYPE=W for reference points that are not always 
included. The link-edit will not fail if the entry point cannot be found. 
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Shift Macros—Shift a Register to the Left or Right 


The shift macros generate the statements that shift a register a specified number of 
bit positions to the right or left. The format is the same for all shift macros. The 
shift macros are as follows. 


Macro Function 

SLL Shifts a 22-bit register to the left. 
SLLB Shifts a register byte to the left. 
SLLH Shifts a 16-bit register to the left. 
SRL Shifts a 22-bit register to the right. 
SRLB Shifts a register byte to the right. 
SRLH Shifts a 16-bit register to the right. 


Syntax 


SLL (register) ,—count 
name SLLB 

SLLH 

SRL 

SRLB 

SRLH 


Parameters 


>—(register) ,—_—_—__—_—_ 


Function Specifies a register to be shifted. 
Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 


»>—c ount—_—_—___—__—_———————————_uOouwuKx 


Function Specifies the number of positions to shift the register. 
Format Absolute notation between 0 and 16. 
Default None. 


Remarks The contents of register 1(0) are destroyed if a count greater than 3 is 
specified. 
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STRM—Store a Series of Registers 


The STRM macro sequentially stores a specified series of registers, starting in a 
specified area of storage. The macro stores all 24 bits of each register into a 
4-byte storage location. 


The registers must be coded in ascending order. Register 0 is not allowed. 


Syntax 
cour DR Ser rst_register,——______;_ {displacement ,register )—_—__________—»« 
name last_register 


Parameters 


»>—first_register ,—___-___—__ > 


Function Specifies the first register in a series to be stored. 
Format Absolute register notation. 


Default None. 


a (SE (aaa aaa 
last_register 


Function Specifies the last register in a series to be stored. 
Format Absolute register notation. 


Default None. 
»>—(displacement ,register) -———_—_______L—»~ 


Function Specifies the starting address of the storage location into which the first 
register in the series is to be stored. 


Format Base-displacement notation; the displacement must be a multiple of 4. 


Default None. 
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SUBRTN—Define a Subroutine Entry Point 


The SUBRTN macro defines a subroutine entry point. This macro is used at the 
start of any subroutine that is to be invoked by the CALL macro. 


Syntax 


>>—name—SUBRIN 


» ATTR=NONREENT 
=~ eed 
~LREENT 


Parameters 


>>—name 


Function Specifies the name of the subroutine and is identical to the subroutine 
name specified on the CALL macro for this routine. 


Format Any symbol of 7 or fewer characters. 


Default None. 


»ATTR=NONREENT | 
“~— a 
~LReENT 
Function Specifies whether the subroutine is reentrant or nonreentrant. 


Format REENT or NONREENT. 
Default NONREENT. 
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SVLINK—Link to the SVC Service Routine 


Syntax 


The SVLINK macro is used within a supervisor call (SVC) macro to link directly to 
the SVC service routine. 


Register 0 is not allowed for register parameters. 


SVLINK—SVC_service_rout ine-—____________————— 


name 


Parameters 


Er 
»—7 BALI 
BAL7 
(function output) 
L WORKR= (two rk_regis i 4 
L SAVER= Progen ae 


>—SVC_service_routine 


Function Specifies the address of the SVC service routine. 
Format Label notation. 
Default None. 


Remarks On the first occurrence of an external SVC service routine label in a 
module, an EXTRN statement for that label is generated. 


L 45 VC_parame te 7.) 


Function Specifies one or more 4-byte parameter values to be passed to the SVC 
service routine. 


Format Any valid assembler expression. 
Default No parameter values are passed. 


Remarks lf BAL1 or BAL7 is specified, the first parameter passed to the SVC 
service routine is 2 bytes long, rather than 4 bytes. 
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»—7-BAL1 
BAL7 
(function output) 


Function Specifies the registers to receive one or more output values from the 
SVC service routine. BAL1 and BAL7 specify that a more efficient 
linkage to the SVC service routine is generated, but these keywords pre- 
clude receiving any function-output values from the SVC service routine. 


Format Register notation. 
Default No function-output values are returned. 


Remarks lf you specify BAL1, the contents of register 1 are not preserved. If you 
specify BAL7, the contents of register 7 are not preserved. 


If you specify BAL1 or BAL7, the name field is optional; if you specify 
function output, you must specify the name field. 


kona (ore regis ie 


Function Specifies one or more work registers, the contents of which may be 
altered during execution of the macro. Specifying such registers makes 
execution of the SVC service routine more efficient. This keyword is 
used with the SAVER keyword to determine which registers do not have 
to be saved in the SVC service routine. 


Format You can use any or all of the following registers: 1, 2, 3, 4,5, and 7. 
Do not use equated values. 


Default No work registers. 


a SAVER= Seeger 


Function Specifies registers that are initially saved in the SVC service routine. 
This keyword is used with WORKR to determine which register saves in 
the SVC service routine can be skipped to provide better performance. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, 
and 7. Do not use equated values. 


Default All six registers are saved. 


Remarks The registers specified in this keyword must match exactly those regis- 
ters specified on the SAVE1 keyword of the SVC's SUPVNUC@ macro. 
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SWAP—Exchange the Contents of Two Registers 


The SWAP macro generates a series of exclusive OR instructions that exchange 
the contents of two registers without using a third register or a storage location. 


Register 0 is not allowed for register parameters. 


Syntax 
eee ee ee »—(ry) 


» REG=R 

»REG=——CR 
HR 
R 


>—(rx), 


Parameters 


Function Specifies the first register of the exchange. 


Format Register notation if REG=HR or REG=R; byte register notation if 
REG=CR. 


Default None. 
>— (ry) $$ 


Function Specifies the second register, the contents of which is to be exchanged. 


Format Register notation if REG=HR or REG=R; byte register notation if 
REG=CR. 


Default None. 


»REG=R 

»REG=——CR 
HR 
R 


Function Specifies whether 8-bit (CR) registers, 16-bit (HR) registers, or 22-bit (R) 
registers are to be exchanged. 


Format CR, HR, or R. 
Default R. 
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SYSXiIT—Return Control to Supervisor after an Executed Task 
The SYSXIT macro returns control to the supervisor when the task has completed 
its execution. 


For additional information on how the SYSXIT macro affects task states, see the 
section “Task Management” in NCP and EP Reference. 


Syntax 
name 
> QPOST=NO 
te 
» TRIGGER=YES 
» |RIGGER=——NO 
Leyes 
Parameters 


Pa cerioarertn i naieiconemeineen| 
»QPOST= 0 
» TRIGGER=YES 
vo ere 
» TRIGGER=——NO 
Les 


Function Specifies whether the issuing task's input or pseudo-input queue is to be 
reactivated. If YES, the TRIGGER keyword indicates whether the queue 
is to be triggered. 


Format YES or NO. 
Default NO for QPOST; YES for TRIGGER. 
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TAGBUFF—Set the Buffer-Tag Field of a BH Control Block 


The TAGBUFF macro sets the buffer-tag field of the buffer prefix (BH control block) 
for a specified buffer with a specified status. The status indicates the buffer's 
usage. It is referred to when maintenance and debugging procedures require the 
history of the buffer's activity. 


Register 0 is not allowed for register parameters. 


Syntax 


>>—name—TAGBUFF—BUFFPTR=(register) ,—WKREG= (register) ———— HJ 


L FREEPL-—-NO—— 
YES 


» TAG=——CHAIN 
UNCHAIN 
X10 


» SUPV=YES 
Ts 

» TRACE=NO 
ace 


Parameters 


»>—BUFFPTR=(register) ,——__£ 


Function Specifies an odd-numbered register containing the address of the buffer 
to be tagged. 


Format Register notation. 


Default None. 

>—WKREG= (register )——____ 

Function Specifies a 1-byte odd-numbered work register, the contents of which 
may be altered during execution of the macro. 


Format Register notation. 


Default None. 
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ES FREEPL-—-NO——| 
YES 


Function Specifies that the buffer is being released. FREEPL=YES specifies that 
the buffer is being released to the free-buffer pool. FREEPL=NO speci- 
fies that the buffer is leased from the free-buffer pool. 


Format YES or NO. 
Default None. 


Remarks When FREEPL=NO, the buffer-is-not-in-free-buffer-pool status indicator 
is set on, and the remaining buffer-tag status indicators are set off. 


You must code either TAG or FREEPL, but not both. 


» TAG=——CHAIN 
UNCHAIN 
X10 


Function Specifies how buffer status is set. TAG=XIO indicates that the buffer-is- 
initialized-to-the-line-or-link status indicator is set on. TAG=CHAIN indi- 
cates that the buffer-is-chained status indicator is set on. 
TAG=UNCHAIN indicates that the buffer-is-unchained status indicator is 
set on. 


Format XIO, CHAIN, or UNCHAIN. 
Default None. 
Remarks You must code either TAG or FREEPL, but not both. 


, SUPV=YES 
, SUPV=——NO 
= 


Function Specifies the level in which the issuer is running. SUPV=YES specifies 
that this macro is used in an interrupt level. SUPV=NO indicates that 
this macro is used in level 5. 


Format YES or NO. 
Default YES. 


Remarks Inline code is always generated regardless of the value of SUPV. 
» TRACE=NO 
, TRACE=——YES 
E 


Function Specifies whether the buffer address and location will be logged in the 
ABN diagnostic area if an abend occurs. 


Format YES or NO. 
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Default NO. 
Remarks If YES is specified, dsect XCXTABN must be included in the assembly. 
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TESTTGB—Test States and Conditions of a TGB 


The TESTTGB macro checks specific states and conditions within a transmission 
group control block (TGB). It can also return the data link control (DLC) control 
block address currently associated with the TGB and the transmission group 
number (TGN) of the TGB. 


Register 0 is not allowed for register parameters. 


Syntax 


pe 7 TEST TGB— (£gb_address) : DLCB= (register) 
name TGN=(register) 

STATUS=——SNA3 

SNA4 

(LASTDLC, (reason_register) ) 


STATE=——ACTIVE 
penta: 


INACTIVE 


PENDING 
»>—ERROR=——SETZ , —WORKR= (work_register) 
SETNC 
SETZNC 
Parameters 


»—(tgb_address) ,—@_$ : 


Function Specifies the register that contains the TGB under test. 
Format Register notation. 
Default None. 


Remarks The register cannot be the same as the register specified on the 
WORKR, DLCB, TGN, or STATUS keywords. 


You must provide the TGB DSECT. 
»>—DLCB=(register) <-———_—______________————— —  — 


Function Specifies the return register for the data link control block address of the 
specified transmission group block. Returns a value of 0 if no DLC is 
currently associated with the TGB. 


Format Register notation. 
Default None. 


Remarks The register cannot be the same as the TGB address register. You 
must specify exactly one of the following keywords: DLCB, TGN, 
STATUS, or STATE. 
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>—TIGN=(register) ,———______ 


Function Specifies the register into which the TGN is to be returned. 
Format The register must be a byte register. 
Default None. 


Remarks The register you specify cannot be the same as that specified for the 
TGB address or the DLCB keyword. You must specify exactly one of 
the following keywords: DLCB, TGN, STATUS, or STATE. 


»>—STATUS=——SNA3 cre rrr 
ne 
(LASTDLC, (reason_register)) 


Function Specifies the status to be tested for. SNA3 and SNA4 indicate the level 
of the adjoining node data link control. An indicator value is returned in 
the reason register to give the reason the data link control became inop- 
erative the last time. 


Format SNA3, SNA4, or (LASTDLC,(reason register). The reason register is a 
byte register. 


Default None. 


Remarks The register specified as the reason register cannot be the same as the 
register that points to the TGB under test. You must specify exactly one 
of the following keywords: DLCB, TGN, STATUS, or STATE. 


>—STATE=— ACTIVE , 
ERPENDOP 
INACTIVE 
PENDIN 


Function Specifies the state to be tested for. ACTIVE means that the TGB is 
operational and able to transfer data between path control and data link 
control. 


ERPENDOP means that the data link control is active and the explicit 
route manager has been notified, but its processing to become fully 
active has not been completed. 


INACTIVE means that: 
e The TGB is currently not associated with a data link control 


e The explicit route control function for all explicit routes associated 
with the TGB is reset. 


PENDING means that the TGB is not in the ACTIVE, INACTIVE, or 
ERPENDOP state. 


Format ACTIVE, ERPENDOP, PENDING, or INACTIVE. 
Default None. 


Remarks You must specify exactly one of the following keywords: DLCB, TGN, 
STATUS, or STATE. 
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>—E oan” ETZ 


Function 


Format 
Default 


Remarks 


TESTTGB 


SETNC 
SETZNC 


Specifies whether the C latch, Z latch, or both are to indicate whether 
the TGB is in the specified state or level. 


SETZNC, SETZ, or SETNC. 
None. 


If the TGB is not in the specified state or level, the Z latch is set to 1, 
and the C latch is set to 0. If the TGB is in the specified state or level, 
the Z latch is set to 0, and the C latch is set to 1. 


>—WORKR= (work_regis ter) A 


Function 


Format 
Default 


Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. 


The register must be a byte register. 
None. 


This register cannot be the same as the register specified for the TGB 
address or the LASTDLC, DLCB, or TGN keyword. 


You do not have to code WORKR when STATUS=(LASTDLC, (reason 
registen), DLCB=(register), or TGN=(register). 
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THEN—Begin IF Macro True Condition Instructions 


The THEN macro is used with the IF, ANDIF, ORIF, ELSE, and ENDIF macros to 
form an IF-THEN-ELSE program structure. It prefixes the instructions that are exe- 
cuted if the conditions of the IF macro are true. 


Syntax 
sa SOT ie THEN 
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TPPOST—Discard a BCU after Processing 


The TPPOST macro is used by any routine to discard a block control unit (BCU) after processing has 
been completed or after processing has been stopped because of an error condition. 


Register 0 is not allowed for register parameters. 


Syntax 


as EER Ia (beu0ddress) espns eS aS Se 
name 


» DATADS P=RELEASE 


» DATADS P= 
» BHRCHK=N 
os = 
Ly ES 
, SUPV=NO 
, SUPV¥=——NO 
< 


Parameters 


»—(bcu_address) ,—_-______—— 


Function Specifies the register containing the address of the BCU that is to be 
discarded. 


Format Register notation. 
Default None. 


Remarks If SUPV=YES, register 1 or register 6 is not allowed. Register 3 is 
standard. 


The BCU must not reside on a queue and must contain a valid virtual 
route vector table (VVT) index. 


>—response—___- SS 


Function Specifies the bit configuration to be stored in the system response byte 
in the BTU. 


Format Byte register notation or absolute notation (0 to 255). 
Default None. 


Remarks Register 1(0) is standard. 
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, DATADS P=RELEASE 
a oy 
/ RELEASE 
SYSOPT 
Function Specifies what is to be done with the buffers in the BCU. RELEASE 
indicates that the buffer is to be released. 


PASS indicates that the buffer chain is not to be released. 


SYSOPT specifies that the general communication byte (SYSFLGO) is to 
be examined to determine whether to release data. 


Format RELEASE or PASS. 
Default RELEASE. 


» BHRCHK=N 
» BHRCHK=——NO 
ea 


Function Specifies whether point 3 block handler routine access is to be allowed 


for the BCU. 
Format YES or NO. 
Default NO. 


, SUPV=NO 
a =e 
~Lyes 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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TRACEPiIU—Trace PIUs 


The TRACEPIU macro provides a path information unit (PIU) trace facility in NCP. 
An activate-line-trace PIU must be received to activate the PIU trace. The records 
are sent to the resource given in the origin address field (OAF) of this activate-line- 
trace PIU. The trace records generated by the TRACEPIU macro can be proc- 
essed in the host by the Advanced Communications Function for the Trace 
Analysis Program (ACF/TAP). 


The TRACEPIU macro starts, continues, stops, or aborts a PIU trace. When the 
TRACEPIU macro is executed, its service routine (CXATRAC#) can do the fol- 
lowing: 


Format the record trace data (RECTRD) PIU, including the ID specified 
Store the trace data into the RECTRD PIU 

Insert the proper ending code into the RECTRD PIU status field 
Enqueue the buffer that returns the RECTRD PIU to the SSCP 

Select data to be traced. 


Register 0 is not allowed for register parameters. 


Starting a PIU Trace 


Syntax 


cee (SP cal (register) ,—MODE=START ,—PIU= (register) ,—ID=char-——_________—> 
name 


Parameters 


— 
» TRANSPRT=n 
, SUPV=NO 
, SUPV=——NO 
— 


>—TRACPTR=(register) ,———_____ 


Function Specifies the register that points to a one-word storage location used by 
CXATRAC# to save the address of the buffer for this RECTRD PIU. 
Later, the data to be traced will be copied into this buffer. This storage 
word must be initialized to 0 before the execution of the TRACEPIU 
macro (MODE=START) and should be operated on only by the 
TRACEPIU macro. You must ensure that this storage word always 
points to the buffer; if not, data could be randomly stored in storage that 
contains the network control program. 


Format Register notation. 


Default None. 
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MODES a Sa EE 


Function Specifies the start of the PIU trace. Causes the CXATRAC# service 
routine to lease a buffer and initialize it to a RECTRD PIU format. 
CXATRAC# uses the pointer from the PIU=(register) keyword to address 
the activate line trace PIU to get information to use in initializing the 
RECTRD PIU format. The value specified in the ID keyword is used in 
this RECTRD PIU. CXATRAC# then stores the buffer address in the 
one-word storage location supplied by the TRACPTR keyword. If an 
error occurs, CXATRAC# sets an error return code in the condition 
latches (C=1 and Z=0) for SUPV=NO. For SUPV=YES, return codes 
set in register 3(1) are: 


X'00' No error 
X'FO' Sequence error; two consecutive starts 
X'FF' Error condition. 


Format START. 
Default None. 


»>—PIU=(register) ,—_—_—_—____——————————————————— > 


Function Specifies the register containing the address of the activate-line-trace 
PIU. 


Format Register notation. 
Default None. 


Remarks When MODE=START is specified, the register must point to an activate- 
line-trace PIU request. 


BC Pan 


Function Specifies an alphabetical character or number to be used to identify the 
type of PIU trace to ACF/TAP. The character or number identifies 
records in the trace data output. 


Format One alphabetical character (A to Z) or one digit (0 to 9). 
Default None. 
Remarks Required with the MODE=START keyword. 


You can use the digits 0 to 9. The alphabetical characters are reserved 
for IBM use. 
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» TRANSPRT=0 
oan 
Function Specifies the number of PlUs to be traced and recorded in each 
RECTRD PIU before it is transmitted to the host. 
Format Absolute values 0 to 7. 


Default 0. 


Remarks When TRNSPRT=0, one buffer is copied up to the length of the initial 
buffer. When TRNSPRT=1, one PIU is copied and additional buffers 
are leased if needed. 


The count does not include skipped PiUs. For more information, see 
MODE=CONTINUE under “Continuing a PIU Trace.” 


, SUPV=NO 
mer? —— 
Leyes 
Function Specifies the level in which the issuer is running. SUPV=NO specifies 


that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 


Continuing a PIU Trace 


Syntax 
>> 77 TRACEPIU—TRACPTR= (register) > —MODE=CONTINUE ,—PIU= (register) ———'> 


name 
» LENGTH=39 
E ea 
VARY 
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»>—TRACPTR= (register) $$ > 


Function Specifies the register pointing to a one-word storage location that is 


Format 
Default 


used by CXATRAC# to save the address of the buffer for this RECTRD 
PIU. The data to be traced is copied into this buffer. This storage word 


should be referred to only by the TRACEPIU macro. You must ensure 


that this storage word always points to the buffer; if not, data could be 
randomly stored in storage that contains the network control program. A 
unique storage fullword must be supplied for each concurrent trace. 


Register notation. 


None. 


>—MODE=CONT INUE,_-_A A 


Function Specifies the transfer of the data to be traced. Causes the CXATRAC# 


Format 
Default 


service routine to transfer the data to be traced by copying the data from 
the PIU specified by the PIU keyword into the buffer pointed to by 
TRNSPRT. Copying begins with the first byte of the transmission 
header, which is stored in the next available byte of the RECTRD PIU. 
CXATRAC# transfers the number of bytes specified by LENGTH. If the 
TRNSPRT keyword is 0 when the trace is started, data is truncated if 
the buffer fills. If TRNSPRT is 1 to 7, additional buffers are leased if 
needed. If no buffers can be leased, no bytes are copied and the PIU is 
skipped. If an error occurs, CKATRAC# sets an error return code in the 
condition latches (C=1, Z=0). For SUPV=YES, return codes set in reg- 
ister 3(1) are: 


X'00' No error 
X'FO' Sequence error; continue issued before start 
X'FF' Error condition. 


CONTINUE. 


None. 


»>—PIU=(register) 


Function Specifies the register containing the address of the PIU to be traced. 


Format 
Default 


Register notation. 


None. 
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, LENGTH=39 
aan 
VARY 
Function Specifies the number of bytes to be traced from the PIU specified by the 
PIU keyword beginning with the first byte of the transmission header. 


m may be any absolute value from 1 to 255. For VARY, the number of 
bytes depends on the type of SNA response header as follows: 


(RH) Type Fields Traced 

CFC, NS, SC TH, RH, and RU 

FMD (character coded) TH and RH 

FMD (field format) TH, RH, and 6 bytes of RU 


Format ™m (absolute value from 1 to 255). VARY. 
Default 39. 


Remarks If TRNSPRT=0 for MODE=START, do not code VARY for 
MODE=CONTINUE. 


Stopping a PIU Trace 


Syntax 
alae (RING pce ls ist »—MODE=(STOP, SLODWN 
name Cer onee ( beac 
OTLAST 
Parameters 


>—TRACPTR=(register), 


Function Specifies the register pointing to a one-word storage location used by 
CXATRAC# to save the address of the buffer for this RECTRD PIU. 


Format Register notation. 


Default None. 


DEAC 


>—MODE= eT eae ) 
NOTLAST 


Function Specifies the end of the PIU trace. Causes the CXATRAC# service 
routine to terminate the PIU trace. 


The second keyword can be: 


SLODWN ___Last record, no buffers available in buffer pool 
DEAC Last record, deactivate received 
NOTLAST Not last record. 
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Syntax 


Format 


Default 
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When you specify MODE=STOP, CXATRAC# places the proper code 
(X'01' for NOTLAST, X'02' for DEAC, and X'03' for SLODWN) into 
the RECTRD PIU status field and sends the RECTRD PIU to the SSCP. 
lt then sets the address in the storage location pointed to by TRACPTR 
to 0 and exits. When you specify MODE=STOP, CXATRAC# ends the 
trace with notification to the SSCP. Use SLODWN or DEAC when ter- 
mination of the trace is to be signaled to the host. NOTLAST stops the 
trace, but will not signal termination of the trace to the host. 


Note: Use caution when PIU trace and normal line trace are active. 
Once VTAM* or TCAM receives a termination notice (DEAC or 
SLODWN), it stops recording trace records for the line. Succeeding 
record trace PIUs sent to the host for a line will be discarded. 


The return code set in register 3(1) is 0 (no error). 
(STOP,SLODWN);(STOP,DEAC); or (STOP,NOTLAST). 


None. 


acs a Fe ea aa (register) ,—MODE=ABORT——________YY—"'‘ 
name 


Parameters 
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Function Specifies the register pointing to a one-word storage location used by 


Format 
Default 


CXATRAC# to save the address of the buffer for this RECTRD PIU. 
The buffer pointed to by this fullword is to be released to the free buffer 
pool by this operation. Ensure that this storage word always points to 
the buffer. 


Register notation. 


None. 
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> MO0E-ACO = Se ee 


Function Specifies that the PIU trace be terminated. Causes the CKATRAC# 
service routine to end the trace operation without notifying the SSCP, 
release the buffer to the buffer pool, set the address in the storage 
location pointed to by TRACPTR to 0, and then exit. Use 
MODE=ABORT when the PIU trace can be started and the normal line 
trace cannot be started. Also use it during automatic network shutdown 
(ANS). Use this mode to terminate the trace when normal line trace 
activity will signal the host that line trace has been terminated. The 
return code set in register 3(1) is 0 (no error) for SUPV=YES. 


Format ABORT. 
Default None. 
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TRIGGER—Schedule a Task for Execution 


Syntax 


p>>—name—TRIGGER 


The TRIGGER macro places a specified task in the pending state and schedules 
the task for execution. 


Tasks are scheduled on a first-in, first-out (FIFO) basis with other tasks of the same 
dispatching priority. The hierarchy of priorities is, from highest to lowest: 
appendage, immediate, productive, and nonproductive. 


A task is pending from the time it is triggered until it is dispatched. From the time it 
is dispatched until a QPOST macro is issued for it, a task is in the active state. 
The task changes to active and ready after the QPOST and remains this way until 
SYSXIT. 


If you specify TYPE=COND, the supervisor ignores the trigger request unless a 
QPOST macro has been issued for the designated task. If you specify TYPE=UC, 
the supervisor will trigger the task regardless of whether a QPOST macro has been 
issued for the task. 


A trigger request for a pending task is always ignored, regardless of the TYPE 
specification, because trigger requests are not remembered by the supervisor. 


For additional information on specifying task priority and on how the TRIGGER 
macro affects task states, see “Task Management” in NCP and EP Reference. 


Register 0 is not allowed for register parameters. 


Lye address 
, TYPE=CON | 
a 
, SUPV=NO 
Ts 
, ENABLE3=YES 
Cone 
ae 
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Parameters 


Lgeniaddrees= 


Function Specifies the address of the input or pseudo-input queue control block 
(QCB) governing the task to be activated. 


Format Register or label notation. 


Default If SUPV=YES, there ts no default. If SUPV=NO, the QCB that activated 
the issuing task is triggered. 


Remarks Register 1 is not allowed. 


If SUPV=YES, register 2 is standard, and register 6 is not allowed. 


, TYPE=CON 
ores —— 


Function Specifies whether the execution of this macro is to depend on the speci- 
fied task being ready, that is, a Q@POST macro having been issued for 
the task. Unit check (UC) causes the supervisor to trigger in any case. 


Format UC or COND. 
Default COND. 


» SUPV=NO 
a — 
—Lyes 
Function Specifies whether the macro is to issue a supervisor request to level 4 
or Is to link directly to the trigger routine. 


Format YES or NO. 
Default NO. 


» ENABLE3=YES 
es =e 
Lives 
Function Specifies whether level 3 interrupts are to be enabled at the completion 
of the lease. 


ENABLE3=YES allows both level 2 and level 3 interrupts to be enabled 
at the completion of the lease. ENABLE3=NO allows a level 4 routine 
to inhibit level 3 interrupts and to issue a lease. Only level 2 interrupts 
are enabled at the completion of the LEASE when ENABLE3=N0O is 
coded. 
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Format YES or NO. 
Default YES. 
Remarks Use this parameter only when SUPV=YES. 


—e tons | 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default No work registers. 


Remarks Register 6 is not allowed. 
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TVSIDL—Start an Idle Time-Out for a Line 


The TVSIDL macro starts an idle time-out for a communication line. Character 
control block (CCB) addressability and the time value select (TVS) DSECT 
(XXCXTTVS) are required. This macro is intended for use by program level 2 or 3. 
When TVSIDL is used in program level 4 or 5, program level 2 or 3 may cause 
interference. Therefore, disable program level 3 if this macro is used in program 
level 4. Do not use it in program level 5. 


Syntax 


pea ENO red Se) eee 
name 
» FUNC=FULL 
» FUNC=——FULL 
Leen ERATE 
STORE 


»—(work_register )—___———____ > 


Parameters 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Byte register notation. 
Default None. 


Remarks Register 0 is not allowed. 


» FUNC=FULL 

» FUNC=——FULL 
GENERATE 
STORE 


Function Manipulates the timer command. If FUNC=FULL, the timer command is 
generated and stored in the appropriate CCB field. If 
FUNC=GENERATE, the timer command is generated and placed in the 
work register. If FUNC=STORE, the contents of the work register are 
placed in the appropriate CCB field. 


Format FULL, GENERATE, or STORE. 
Default FULL. 
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TVSMOD—Change the Current Time-Out Type 


The TVSMOD macro changes the type of time-out in effect without changing its 
value. CCB addressability and the time value select (TVS) DSECT (XXCXTTVS) 
are required. This macro is intended for use by program level 2 or 3. When 
TVSMOD is used in program level 4 or 5, program level 2 or 3 may cause interfer- 
ence. Therefore, disable program level 3 if this macro is used in program level 4. 
Do not use it in program level 5. 


Syntax 
cas EG a (work_register) 
name 


, FUNC=FULL 
, FUNC=——FULL 
GENERATE 
STORE 
, CMDCHNG=SHLDRTAP 
| , CMDCHNG=——ERRORTO 
Hitrpcep 
SHLDRTAP 


»>—(work_register) —_—________— 


Parameters 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format _Byte-register notation. 
Default None. 


Remarks Register 0 is not allowed. 


» FUNC=FULL 

» FUNC=——FULL 
GENERATE 
STORE 


Function Manipulates the timer command. If FUNC=FULL, the timer command is 
generated and stored in the appropriate CCB field. If 
FUNC=GENERATE, the timer command is generated and placed in the 
work register. If FUNC=STORE, the contents of the work register are 
placed in the appropriate CCB field. 


Format FULL, GENERATE, or STORE. 
Default FULL. 
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» CMDCHNG=SHLDRTAP 


ERRORTO 
FLIPCMD 
SHLDRTAP 


, CMDCHNG= 


Function Alters the type of time-out command in effect: 
¢e CMDCHNG=ERRORTO initiates an error time-out. 


¢ CMDCHNG=FLIPCMD toggles between an error time-out and a 
shoulder-tap time-out. If the previous time-out was an error 
time-out, the error time-out is changed to a shoulder-tap time-out. If 
CMDCHNG=FLIPCMD and the previous time-out was a shoulder-tap 
time-out, the shoulder-tap time-out is changed to an error time-out. 


¢ CMDCHNG=SHLDRTAP initiates a shoulder-tap time-out. 
Format ERRORTO, FLIPCMD, or SHLDRTAP. 
Default SHLDRTAP. 
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TVSNEW—Start a Time-Out for a Line 


The TVSNEW macro starts a communication line time-out. The time-out command 
is contained in a register. CCB addressability and the time value select (TVS) 
DSECT (XXCXTTVS) are required. This macro is intended for use by program 
level 2 or 3. When TVSNEW is used in program level 4 or 5, program level 2 or 3 
may cause interference. Therefore, disable program level 3 if this macro is used in 
program level 4. Do not use it in program level 5. 


Register 0 is not allowed for register parameters. 


Syntax 


>> —_—_ WSNEW— (work_register) ,—(command_regis ter) —— 
name 
» FUNC=FULL 
» FUNC=——FULL 
GENERATE 
STORE 


>—(vork_register) ——_£_ —___$ 


Parameters 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. ; 


Format Byte register notation. 


Default None. 
>—(comand_register ) 


Function Specifies the register containing the new time-out command. 
Format Byte register notation. 


Default None. 


» FUNC=FULL , 
= — 
GENERATE 
STORE 
Function Manipulates the timer command. If FUNC=FULL, the timer command is 
generated and stored in the appropriate CCB field. If 
FUNC=GENERATE, the timer command is generated and placed in the 
work register. If FUNC=STORE, the contents of the work register are 
placed in the appropriate CCB field. 


Format FULL, GENERATE, or STORE. 
Default FULL. 
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TVSRAS—Start an RAS Time-Out for a Line 


The TVSRAS macro starts a reliability, availability, serviceability (RAS) time-out for 
a communication line. CCB addressability and the time value select (TVS) DSECT 
(XXCXTTVS) are required. This macro is intended for use by program level 2 or 3. 
When TVRAS is used in program level 4, program level 2 or 3 may cause interfer- 
ence. Therefore, disable program level 3 if this macro is used in program level 4. 
Do not use it in program level 5. 


Syntax 


Se 
name 
» FUNC=FULL 
» FUNC=——FULL 
GENERATE 
STORE 


»—(work_register)-—_—@ —-—_________— 


Parameters 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Byte register notation. 
Default None. 


Remarks Register 0 is not allowed. 


» FUNC=FULL 

» FUNC=——FULL 
GENERATE 
STORE 


Function Manipulates the timer command. If FUNC=FULL, the timer command is 
generated and stored in the appropriate CCB field. If 
FUNC=GENERATE, the timer command is generated and placed in the 
work register. If FUNC=STORE, the contents of the work register are 
placed in the appropriate CCB field. 


Format FULL, GENERATE, or STORE. 
Default FULL. 
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TVSREF—Refresh or Restart a Time-Out for a Line 


The TVSREF macro refreshes or restarts a communication line time-out. CCB 
addressability, the timer value select (TVS) DSECT (XXCXTTVS), and the 
SYSEQU (XSYSEQU) are required. This macro is intended for use by program 
levels 2 and 3. When TVSREF is used in program level 4, program level 2 or 3 
may cause interference. Therefore, disable program level 3 if this macro is used in 
program level 4. Do not use it in program level 5. 


Syntax 
Pay ee = es NOTES EON cca ee ee 
name 
» FUNC=FULL 
GENERATE 
STORE 
Parameters 


>—(work_regis ter) —@£@— — > 


Function Specifies an odd-numbered work register, the contents of which may be 
altered during execution of the macro. 


Format Register notation. 
Default None. 


Remarks Register 0 is not allowed. 


» FUNC=FULL 

» FUNC=——FULL 
GENERATE 
STORE 


Function Manipulates the timer command. If FUNC=FULL, the timer command is 
generated and stored in the appropriate CCB field. If 
FUNC=GENERATE, the timer command is generated and placed in the 
specified work register. If FUNC=STORE, the contents of the work reg- 
isters are placed in the appropriate CCB field. 


Format FULL, GENERATE, or STORE. 
Default FULL. 
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Function Alters the type of time-out command in effect: 
e CMDCHNGENO specifies no change. 
e CMDCHNG=ERRORTO initiates an error time-out. 


e CMDCHNG=FLIPCMD toggles between an error time-out and a 
shoulder-tap time-out. If the previous time-out was an error 
time-out, the error time-out is changed to a shoulder-tap time-out. If 
CMDCHNG=FLIPCMD and the previous time-out was a shoulder-tap 
time-out, the shoulder-tap time-out is changed to an error time-out. 


e CMDCHNG=SHLDRTAP initiates a shoulder-tap time-out. 
Format NO, ERRORTO, FLIPCMD, or SHLDRTAP. 
Default NO. 
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TVSRTRN—Generate a Return Linkage from a Timer Routine 


The TVSRTRN macro generates the proper return linkage to NCP from your timer 
routines. When control is returned to NCP, register 6 must contain the same 
address that was passed to your timer routines. 


Syntax 
ee a N 
name 
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TVSTIME—Start a Time-Out for a Line after a Time Interval 


The TVSTIME macro starts a line time-out after a specified time interval. It does 
not use a time-out command. A timer service is available every 100 milliseconds 
for line adapters that use the high-resolution line timer (SDLC, BSC, and pro- 
grammed resources). A timer service Is available every 500 milliseconds for start- 
stop line adapters that use the low-resolution line timer. The TICKS keyword 
specifies the time interval, not as a time value, but as the number of times that the 
line timer function services the associated line adapter before completion of the 
time-out. 


To ensure that a certain time-out interval has elapsed, the number of ticks that 
must be specified is the number of ticks for that time interval, plus 1. This is how 
the value used for normal NCP time-out commands is calculated. The reason for 
the additional tick is that the time until the first timer interrupt (tick) is indeterminate 
and may be very short; the time between that first tick and the last one is at least 
as long as the duration of the time-out. Thus, the first tick should not be counted 
as part of the time-out interval. Because the line timer runs asynchronously with 
NCP, a TICKS value of 1 results in a line time-out on the next available line-timer 
service (any time up to 100 milliseconds for a high-resolution line timer, or up to 
500 milliseconds for a low-resolution line timer). Likewise, a TICKS value of 3 
results in a line time-out on the third available line timer service (any time from 201 
milliseconds up to 300 milliseconds for a high-resolution line timer, or from 1001 
milliseconds up to 1500 milliseconds for a low-resolution line timer). 


The type of time-out can be specified as either an error time-out or a shoulder-tap 
time-out. When the time-out is completed, the action that the line-timer function 
takes is the same as that taken when the TVSNEW macro starts an error or 
shoulder-tap time-out. The time-out is canceled if any of the TVS-type macros are 
executed for the same line adapter before the time-out is completed. If TVSREF is 
executed, the time-out expires the next time the line adapter is serviced by the 
timer function. 


The TVSTIME macro must only be executed in a level 3 interrupt or in a level 4 


interrupt while level 3 interrupts are disabled. It must not be executed in interrupt 
level 1 or 2, or in level 5. 


Register 0 is not allowed for register parameters. 


Syntax 
occa AE Fie So ea ,—ACB= (register) —£@@———H—_—H—H—_______——> 
name 


» TYPE=ERRORTO 
E TYPE= avn 
Lu LDRTAP 


L WKREG=(register)— 
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»>—TICKS=n, 


Function Specifies the number of times the timer function must service the line 
adapter before the time-out is completed. 


Format —_Halfword register or label notation. 
Default None. 


Remarks The maximum number of ticks is 16 383. The value 0 results in the 
maximum time-out (16 384 ticks). Only the low-order 14 bits in the 
specified register or in the specified value are used. 


lf a register is used, it cannot be the same as the register specified on 
any other keyword. 


The WORKR keyword can be omitted for more efficient macro expan- 
sion if the TICKS keyword specifies an odd-numbered register and the 
contents of that register need not be preserved. 


»>—ACB=(register )—__________-- 


Function Specifies the register pointing to the adapter control block (ACB) for the 
line adapter on which the line time-out is to be performed. 


Format Register notation. 
Default None. 


Remarks The register cannot be the same as the register specified on any other 
keyword. 


, TYPE=ERRORTO— 


TYPE=——ERRORTO 
~Csutprtap 


Function Specifies that the type of time-out command to be performed is either an 
error time-out or a shoulder-tap time-out. 


Format ERRORTO or SHLDRTAP. 


Default ERRORTO. 
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LL WKREG= (reatster— 


Function Specifies an odd-numbered halfword work register, the contents of 
which may be altered during execution of the macro. 


Format Register notation. 
Default None. 


Remarks The register cannot be the same as the register specified on any other 
keyword. 


This keyword is not required when the TICKS keyword specifies an odd- 
numbered register and the contents of that register need not be pre- 
served; otherwise, it is required. 
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UACTRTN—Pass Control to a User Accounting Exit Routine 


Syntax 


The UACTRTN macro generates a supervisor call (SVC) instruction. It uses as 
input a programmed resource logical unit extension (NLX) pointer and a path infor- 
mation unit (PIU) pointer. It determines if a user accounting exit routine was speci- 
fied during NCP generation. If so, the service routine is invoked to pass control to 
the user accounting exit routine. Code a URETURN macro as the last statement of 
the routine to return control to level 5. If a user routine does not exist, the service 
routine is not invoked. 


Register 0 is not allowed for register parameters. 


>> — —__—UACTRINNLX= (register) »——PIU= (register) ,—WORKR=(register) ,—SUPV=NO--------->« 


name 


Parameters 


>—NLX=(register) ,_-_#£_ 


Function Specifies a register pointing to the NLX. 
Format Register notation. 
Default None. 


Remarks The register used must not be the same as any other input register used 
in this macro. 


Neither register 1 nor register 6 is allowed. 
»>—PIU=(register) _-______ > 


Function Specifies either a register that contains the pointer to the PIU or 0. 
Format Absolute register notation. 
Default None. 


Remarks The register specified must not be the same as any other input register 
used in this macro. Neither register 1 nor register 6 is allowed. 


When the value of the register is 0, the session will be deactivated. 
>—WORKR= (register) —— — > 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Absolute register notation. 
Default None. 


Remarks The register specified must not be the same as any other input register 
used in this macro. Neither register 1 nor register 6 is allowed. 
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>—SUPV=N0O-——A 


Function Specifies that the issuer is running in level 5. 
Format NO. 


Default None. 
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UNCHAIN—Detach a Buffer from a Buffer Chain 


The UNCHAIN macro detaches a specified buffer from an existing buffer chain. 


Register 0 is not allowed for register parameters. 


Syntax 
sic (GSES a a ffer_address 
name 


i lunchained buf feRvaddress)= 


9 


, LAST=—— (branch_address) 
fe ETZ 


, SUPV=NO | 
, SUPV=——NO 
a 
_ Soper 
, DIAG=NO 
E DIAG= =o 
Les 


Parameters 


»>—positional_buffer_address-—£ > 


Function Specifies the register containing the buffer before the buffer to be 
unchained. This buffer can be any member of the chain except the last 
buffer. 


Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 


x linchdined buffernddress) = 


Function Specifies a register into which the supervisor places the address of the 
unchained buffer. 


Format Register notation. 


Default {if SUPV=NO, the unchained buffer address is returned in the positional 
buffer address register. If SUPV=YES, there is no default. 
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Remarks lf the positional buffer is last in the chain, the content of this register is 
set to 0. 


Register 4 is standard. Register 1 is not allowed. If SUPV=YES, reg- 
ister 6 is not allowed. 


,LAST=—— (branch_address ) 
SETZ 
SETNC 


Function Either specifies the address to be given control, or specifies whether the 
C latch, Z latch, or both are to indicate whether the positional buffer is 
the last buffer in the element. 


Format Register notation, label notation, SETZNC, SETZ, or SETNC. 


Default If SUPV=NO, the next instruction after the macro is given control. If 
SUPV=YES, there is no default value. 


Remarks Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 


For SETZNC (Z latch and C latch) or SETZ, the Z latch is set to 1 if the 
buffer is the last buffer in the element or to 0 if is is not. For SETZNC 
or SETNC, the C latch is set to 0 if it is the last buffer in the element or 
to 1 if it is not. 


, SUPV=NO 
— = 
Les 


Function Specifies whether to generate inline code or to issue a supervisor 


request. 
Format YES or NO. 
Default NO. 


— | 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. You can use any or all of the following registers: 1, 
2, 3, 4,5, and 7. Do not use equated values. 


Default No work registers; the contents of all registers are preserved. 
Remarks This keyword is valid only if SUPV=YES. 
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» DIAG=NO 
— — 
~Lyes 
Function Specifies whether the buffer address and location will be logged in the 
ABN diagnostic area if an abend occurs. 


Format YES or NO 
Default NO 


Remarks This keyword is valid only if SUPV=YES is coded. If YES is specified, 
the assembly must include dsect XCXTABN. 


402 NCP, SSP Customization Reference LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” UPARMS 
Licensed Materials — Property of IBM 


UPARMS—Access Fields in the NIX, NLX, NLB, or PIU 


The UPARMS macro executes inline. Its function is to provide access to various 
fields in the network interconnection extension (NIX), programmed resource logical 
unit block extension (NLX), programmed resource logical unit block (NLB), and path 
information unit (PIU). It also provides an interface to the GETIME macro for a 
time stamp. Up to five outputs may be requested during one invocation of the 
UPARMS macro. Registers 1 and 7 are work registers, and their contents are 
destroyed. 


Register 0 is not allowed for register parameters. 


Note: This is an external macro to be used with the gateway accounting exit. 


You must include the following DSECTs in any module that calls the UPARMS 


macro. 
XCXTEQU DIGITS=NO XSYSABNS 
XCXTNIB XSYSSEQU 
XCXTNIX XCXTRCB 
XCXTNLB XCXTPIU TYPE=4, 
XCXTNLX SCRUEQU=(ACTCDRM,REQACT,NOTIFY) 
XCXTUIC 

Syntax 

name 


LPLUNAME=(register)— 
L SLUNAME=(register)— 
L_ PNETID=(register)— 
L SNETID=(register)— 
| PLUSIDE=(register)— 
L SLUSIDE=(register)— 
L_ VRTPF=(register)— 
L_ plu=(register)— 


Le TOD2 (register). 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 2. Macro Directory 403 


UPARMS “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


L psvvti=(register)— 


L sswvti=(register)— 


Parameters 
LPLUNAME= (feuietery=. 


Function Specifies the register pointing to the primary logical unit (PLU) name. 
Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


LE SLUNAME= (Register) 


Function Specifies the register pointing to the secondary logical unit (SLU) name. 
Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


L PNETID=(register)— 


Function Specifies the register pointing to the network ID of the PLU. 
Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


L- SNETID=(register)— 


Function Specifies the register pointing to the network ID of the SLU. 
Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 
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a PLUS IDE= iregistarial 


Function Specifies the registers containing the real and alias addresses of the 
PLU, where realreg is the register to contain the real address, and 
aliasreg is the register to contain the alias address. 


Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


The address contained in the alias register is the address of a PLU in 
another network whose NETID pointer is specified by the PNETID 
keyword. 


is SLUSIDE= inenister)= 


Function Specifies the registers containing the real and alias addresses of the 
SLU, where realreg is the register to contain the real address, and 
aliasreg is the register to contain the alias address. 


Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


The address in the alias register is the address of an SLU in another 
network whose NETID pointer is specified by the SNETID keyword. 


L vRTPF=(register)— 


Function Specifies the byte register containing the VR-TPF field from the PIU 
(byte 3 of the transmission header). The byte register will contain a 
return value in which bits 0 to 3 are the virtual route number and bits 6 
to 7 are the transmission priority field (TPF). 


Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 
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| L piu=(register)— 


Function Specifies the register containing a pointer to the PIU. 
Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


L top- (negisten\= 


Function Contains a pointer to the place where the time stamp is to be put. 
Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


& PSVVTI= egisten 


Function Specifies the register returning the virtual route vector table index (VVTI) 
from the NLX's resource connection block (RCB) on the PLU side of the 
transform. 


Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


If the PLU side NLX ts not attached to a virtual route, the VVT index 
returned will be not allowed (0). 


L ssvvti= (register) 


Function Specifies the register returning the VVTI from the NLX’s RCB on the 
SLU side of the transform. 


Format Register notation. 
Default None. 


Remarks Neither register 1 nor register 7 is allowed. The register must not be the 
same as that specified for any other keyword. 


lf the PLU side NLX is not attached to a virtual route, the VVTI returned 
will be not allowed (0). 
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URETURN—Return Control from a User Accounting Exit Routine 


The URETURN macro generates a supervisor call (SVC) instruction. Use it to pass 
control back to NCP level 5 from your accounting exit routine. 


Note: This is an external macro to be used with the gateway accounting exit. 


Syntax 
Pree oa nee 
name 
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VALQCB—Validate a QCB 


The VALQCB macro generates inline code that examines the identification bits of a 
specified control block and generates a branch to an error address if the control 
block is not a queue control block (QCB). If a QCB is not specified, supply the 
QCB DSECT (XXQCB) and establish addressability to it. 


Register 0 is not allowed for register parameters. 


Syntax 
cai) PE ie (byte_register) »—ERROR=— Label 
name (register) 


»WORK=NO 
» WORK=——NO 
= 


a QCBPTR=(qcb_register)— 


Parameters 


»>—(byte_register) ,@. £@ —£$——————— 


Function Specifies a work register byte. 
Format Byte register notation. 


Default The next instruction after the macro expansion is given control. 


>—ERROR= ee 
“etregister) 


Function Specifies where to branch if the control block is not a QCB, or if itis a 
work QCB and WORKENO is specified. 


Format Register or label notation. 


Default None. 


» WORK=NO 
— “— 
~Lyes 
Function Specifies whether the system work QCBs are to be accepted as valid. 


Format YES or NO. 
Default NO. 
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L QCBPTR= (qcb_register)— 


Function Specifies the register pointing to the QCB. 
Format Register notation. 


Default None. 


Remarks If you do not specify a QCB pointer, you must include the QOCB DSECT 
and have addressability to it. 
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VRACT—Activate an NCP-External Virtual Route 


Syntax 


a SR a (register) 
name 


Parameters 


The VRACT macro requests the virtual route manager to start a virtual route 
external to NCP. The macro is passed either the address of a resource connection 
block (RCB) and a separate virtual route activation work list or the address of an 
RCB that already points to a virtual route activation work list. When activation is 
completed, the task associated with the RCB is triggered, and a return code is put 
in the virtual route work list. The virtual route vector table (VVT) index of the virtual 
route that was started is placed in the RCB. See the NVRID and VRACTCK macro 
descriptions for more information. | 


You do not need to use an ATTACHVR macro if the VRACT macro operation is 
successful. An ATTACHVR macro only attaches a virtual route that has been pre- 
viously activated. The VRACT macro activates a virtual route and automatically 
attaches the virtual route. If the VRACT macro operation is unsuccessful, your 
code must either retry the operation or go on to the next procedure. 


The VRACT macro generates a supervisor call (SVC) instruction. 


Register 0 is not allowed for register parameters. 


LL veL= eecisten) 


» ERROR=SETCNZ 


» ERROR= 
4 
» SUPV=NO 


»>—RCB=(register ) 


Function Specifies the register pointing to your RCB. 
Format Absolute register notation. 
Default None. 


Remarks Neither register 1 nor register 6 is allowed. 
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L vRL- (register 


Function Specifies the register pointing to the separate virtual route activation 
work list. 


Format Register notation. 
Default None. 
Remarks If this keyword is coded, the VRL pointer will be stored in the RCB. 


» ERROR=SETCNZ 


» ERROR= 


Function Specifies whether the C latch, Z latch, or both are to indicate whether 
the virtual route activation was initiated. 


Format SETC, SETNZ, or SETCNZ. 
Default SETCNZ. 


Remarks lf the virtual route to be activated is already active, the C latch is set on, 
and the Z latch is set off. If the virtual route to be activated is not 
active, the C latch is set off, and the Z latch is set on. 


casita 
, SUPV=NO 
Function Specifies that the issuer is running in level 5. 


Format NO. 
Default NO. 
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VRACTCK—Check the Activation of a Virtual Route 


The VRACTCK macro indicates whether activation of a virtual route is successful. 
If activation is successful, the return code register returns the value X'00'. If acti- 
vation is not successful, the register returns X'FF'. Any other value returned is a 
virtual route activation failure code. 


Register 0 is not allowed for register parameters. 


Syntax 


re — 7 VRACTCKRCB= (register) NSN nO 


name 


L RETCODE= (edd registeny= 


| 
, SUPV=NO 


Parameters 


»>—RCB=(register) ,—_—__—__-________—_—_————_--— 


Function Specifies a register pointing to resource connection block (RCB). 


Format Absolute register notation. 


Default None. 


Remarks The RCB register is not preserved. 


L_RETCODE= (odd register) 


Function Specifies an odd-numbered register, the low byte of which will contain 
the return code. The high byte will be used for work. 


Format Absolute register notation. 


Default None. 


Remarks The register specified for RETCODE must not be the same as that 
specified for RCB. The possible return codes are: 


X'00' 
X'01' 
X'03' 
X'04' 
X'05' 
X'06! 
X'FF' 
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Virtual route activation was successful. 
No vector mapping was specified. 

No virtual route resource is available. 
No explicit route is operative. 

No explicit route can be activated. 

No explicit route can be activated. 
Virtual route activation is not complete. 
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as 
» SUPV=NO 
Function Specifies that the issuer is running in level 5. 


Format NO. 
Default NO. 
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VREVENT—Monitor a Virtual Route Exiting the Held State 


The VREVENT macro allows monitoring of a virtual route exiting the held state. 
The queue control block (QCB) pointer contained in the specified event control 
block triggers an awaiting task when the virtual route exits. This macro cannot be 
used if the event control block in the resource connection block (RCB) is in use. 
Register 6 must point to a save area that can be overwritten. 
Register 0 is not allowed for register parameters. 

Syntax 


>> — 7 FREVENT—RCB= rcb_address »—RETCODE= (register) -——@_———_—_—_ 
name TE registers 


, SUPV=NO 
os 
,TYPE=SET 
a 
,NCP=NO 
— 


Parameters 


»>—RCB=——rcb_address ; 
Leqregis ter) 


Function Specifies the RCB associated with an NCP resource and the virtual 
route for the event. 


Format Register or label notation. 
Default None. 


Remarks Use VREVENT only with the virtual route associated with this RCB. The 
register specified must not be the same as that specified for RETCODE. 
Register 6 is not allowed. 


>—RETCODE=(register) 


Function Specifies the register in which a return code is returned. 
Format Register notation (odd-numbered register only) 
Default None. 
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Remarks The return code values are: 


X'0000' The register is 0 if VREVENT is successful. 

X'0002' NO was previously set, or the task is already triggered. 
X'0004' The RCB is not currently associated with a virtual route. 
X'0008' The RCB is attached to a VRB that is inactive. 


Register 6 is not allowed. The register specified cannot be the same as 
that specified for RCB. 


shed 
» SUPV=NO 
Function Specifies the level in which the issuer is running. 


SUPV=NO specifies that the issuer is running in level 5. SUPV=YES 
specifies that the issuer is running in an interrupt level. 


Format NOor YES. 
Default NO. 


» TYPE=SET 
, TYPE=——RESET 
— 


Function Specifies whether a task should be triggered when the virtual route exits 
the held state. TYPE=SET specifies that a task should be triggered. 
TYPE=RESET specifies that the task should not be triggered. 


Format SET or RESET. 
Default SET. 


sNCP=NO 
»NCP=——N 
cf : 


Function Specifies the type of code generated based on the issuer's storage pro- 
tection key. NCP=YES specifies that the issuer is running in NCP 
storage protection key 0; inline code is generated. NCP=NO specifies 
that the issuer is running in NCP storage protection key 1; SVC code is 


generated. 
Format YES or NO. 
Default NO. 


Remarks Specify this parameter only when SUPV=NO. 
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VRIMTASK—Initiate a Task When a Virtual Route Is Held 


The VRIMTASK macro either sets or resets the immediate bit in the resource con- 
nection block (RCB). If the virtual route goes into the held state and the immediate 
bit is set, control is given to the immediate routine whose address is in the RCB. 
Include the DSECTs for XCXTRCB and XCXTEQU in routines issuing this macro. 


Syntax 


Register 0 is not allowed for register parameters. 


Se po K—RCB=rcb_address ,—WKREG= (byte_register) + TYPE=~7—RES ge errs 
name SET 


Parameters 
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»>—RCB=rcb_address, 


Function 


Format 
Default 


Specifies the address of the RCB in which the immediate bit is to be 
either set or reset. 


Register notation. 


None. 


>—WKREG=(byte_register) ,———@ —___——$?[__ or 


Function 


Format 
Default 


Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Byte register notation. 
None. 


The register specified must not be the same as the register specified for 
the RCB keyword. 


»—TVPE=—-RES en ee ee 
SET 


Function 


Format 
Default 


Specifies whether the immediate bit in the RCB should be turned on or 
off. If TYPE=SET, the immediate bit in the RCB should be turned on. If 
TYPE=RESET, the immediate bit should be turned off. 


SET or RESET. 


None. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” XIO 
Licensed Materials — Property of IBM 


XiO—Start an Input/Output Operation 


Line Operations 


This XIO macro enqueues and begins an input/output (I/O) operation on any of the 
BSC, start-stop, or SDLC communication lines and on peripheral channel links. 
This macro is used to interface with program level 2 and 3 code. It can be issued 
only in level 5. 


Register 0 is not allowed for register parameters. 


Syntax 
sacar CSE IMME »—lcb/lkb_address ,— (command) ,—(command-specific_information) ,_#—> 
name LINE 
SETMODE 


>—NOSTART=exception_routtne_address 


Parameters 


IMME , 
LLINE 
SETMODE 


Function Specifies whether an |/O operation will be initiated. If you specify LINE 
for a BSC or start-stop line, an I/O operation will be initiated. If you 
specify LINE for a SDLC link, the line will be enabled, disabled, or 
dialed, or the SDLC link scheduler will be activated. If you specify 
SETMODE, a set mode operation will be initiated. If you specify 
IMMED, an immediate communication function will be initiated. 


Format LINE, SETMODE, or IMMED. 
Default None. 


Remarks There are several different SETMODEs, and the parameters for each 
one are coded differently. The best way to code a SETMODE function 
is to use an existing function as an example. If you code SETMODE or 
IMMED, you must code (command) and NOSTART. 


>—lcb/lkb_address ,<—_____ 


Function Specifies the address of the line control block (BSC/SS) (LCB) or line 
control block (SDLC) (LKB) governing the line on which I/O will be initi- 
ated. 


Format Label or register notation. 


Default None. The supervisor assumes that the program issuing the XIO macro 
has been dispatched from the LCB that will be used. 


Remarks Register 1 is not allowed. 
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»>—(comand) ,——__ > 


Function Specifies a register containing the command, which is found in the 
immediate control flags in the adapter control block (ACB). 


Format Byte register notation. 
Default None. 
Remarks This keyword is not allowed for the LINE function and is required for 


SETMODE and IMMED. Register 1(0) is standard. 


When the SETMODE command is X'26', X'28', X'2A', X'2C', 
X'2E', X'30', X'32', or X'3A', the command must be in register 1(0), 
and a bit selection must be in register 1(1) to indicate the bit to be modi- 


fied or tested. 


Table 6. SETMODE Command Functions 


Command Function 

Value 

X'26' Test SCB bits 

X'28' Set SCB bits 

X'2A' Reset SCB bits 

X'2C' Set CCB bits 

X'2E' Reset CCB bits 

X'30' Test CCB bits 

X'32' Query/add/delete in service order table (SOT) 

X'34' NetView Performance Monitor (NPM) notify request 

X'35' Remove the XID on the LOBQ from the queue (idle line only) 
X'36' Set line control for a peripheral switched line (idle or busy line) 
X'37' Set line control for a peripheral switched line (idle line only) 
X'38' Test for active logical lines 

X'3A' Set subarea dial activity timer 

X'42' Test if the associated physical resource is active 


The bit selection values for X'26', X'28', and X'2A' are: 


X'01' Set/reset/test the control field operation mode bit. 

X'02' Set/reset/test the set normal response mode bit. 

X'03! Set/reset/test both the control field operation mode bit and 
the set normal response mode bit. 

X'04' Test for XID on link outbound queue (only X'26'). 

X'05' Set the ready not received bit to force data link control (DLC) 
to send a poll instead of an | frame (only X'28'). 

X'06' Set waiting on good response (WOGR) bit (only X'28'). 
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The bit selection values for X'2C', X'2E', and X'30' are: 


X'01! 
X'02! 
X'03' 
X'04' 
X'05' 
X'06' 
X'07' 


X'08' 


Set/reset/test the incoming call bit. 

Set/reset/test the link problem determination aid (LPDA) sup- 
ported on the line bit. 

Set/reset/test the LPDA supported on the line bit and the 
LPDA 2 supported on the line bit. 

Set/reset/test the scanner down bit in the LNVT entry. 
Set/reset/test echo-supported bit. 

Reset CCBHPTS bit in CCBSETYP. 

Set the secondary link activity time-out (LATO) timer (only 
X'2C'). 

Reset CCBRBLUC so no disconnect mode U-frames are sent 
in the reset state (only X'2E'). 


When the SETMODE command is X'32', the command must be in reg- 
ister 1(0), and a modifying command is required to be in register 1(1) to 
indicate an operation that will be performed on the service order table 
(SOT). The modifying commands for X'32' are: 


X'01! 
X'02! 
X'03' 


Determine the number of available entries in the SOT. 


Add an SCB/CUB entry in the SOT. 


Delete all occurrences of an SCB/CUB entry from the SOT. 


When the SETMODE command is X'34', the command must be in reg- 
ister 1(0), and a command modifier is in register 1(1). The command 
modifiers for X'34' are: 


X'01! 
X'02! 
X'03' 
X'04' 
X'05' 


Request capability 
START request 
FORWARD request 
STOP request 
Collect data. 


When the SETMODE command is X'35', the command must be in reg- 
ister 1(0), and a modifying command is required to be in register 1(1) 
with a pointer in register 5 to the station control block. There are no 
command modifiers for X'35'. 


When the SETMODE command is X'36' or X'37', the command must 
be in register 1(0), and a modifying command is required to be in reg- 
ister 1(1) with a pointer in register 5 to the station control block. The 
modifying commands for X'36' and X'37' are: 


X'01' 
X'03' 
X'05' 


Set the DLC role to primary. 
Set the DLC role to secondary. 
Set the DLC role to negotiable. 


When the SETMODE command is X'38', the command must be in reg- 
ister 1(0). There are no command modifiers for X'38'. 


When the SETMODE command is X'3A', the command must be in reg- 
ister 1(0), and a modifying command is required to be in register 1(1) to 
indicate an operation that will be performed on the subarea dial timer. 
The modifying commands for X'3A' are: 


X'01' 
X'02' 
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When the SETMODE command is X'42', the command must be in reg- 
ister 1(0) and the command modifier must be in register 1(1). Register 
5 must contain a pointer to the PIU buffers. The command modifiers for 
X'42' are: 

X'01' ACTLINK request 

X'02' CONNOUT request. 


»>—(command-specific_information) ,———— 


Format 
Default 


Function Specifies a register containing the command-specific field. 


Register notation. 


None. 


Remarks This keyword is not allowed for the LINE and IMMED functions and is 


required for some SETMODEs. Register 5 is required. 


When the SETMODE command is X'26', X'28', X'2A', X'2C', 
X'2E', X'30', X'3A', or X'32', the SCB address must be passed in 
this parameter. 


When the SETMODE command is X'34', the address of the user 
resource control block requiring NetView Performance Monitor (NPM) 
activity must be passed in this parameter. 


>—NOSTART=exception_routine_address——H_—_—___________"——'*« 


Function Specifies the address of the routine to receive control if an IMMED or 


Format 
Default 


SETMODE operation cannot be initiated. This parameter is required. 
Register or label notation. 


None. 


Remarks Register 1 is not allowed. 


This keyword is not allowed for the LINE function. 
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SDLC Link Operations 


This XIO macro transfers a path information unit (PIU) or chain of PIUs to a speci- 
fied link outbound queue and begins the I/O routine that transfers the PlUs across 
the communication link. 


Register 0 is not allowed for register parameters. 


Syntax 
fa (I (a O—LINK, ——~——_,— > (piu_adaress ) »— (return_code )——_—> 
name (scb_address) 


, SUPV=NO 
, SUPV=——NO 

Les 
»XID=NO 
»XID=——N 

Lys 

, TAIL=(last_piu_address) 
»MOVE=S INGLE 
»>MOVE=——PRICHAIN 

Cs Inéte 
, WORKR= (Auer register 


Parameters 
>—LINK, 


Function Specifies that this XIO starts I/O on an SDLC link. 
Format LINK. 
Default None. 
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os 


(scb_address) 


Function 


Format 
Default 


Remarks 


Specifies the register pointing to the station control block (SCB) or 
common physical unit block (CUB) on which to enqueue the PIU. The 
PIU is placed on the link outbound queue of the control block. 


Register notation. 
The SCB or CUB that activated the task. 


Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 
Register 2 is standard. 


»>—(piu_address) ,_-____ > 


Function 


Format 
Default 


Remarks 


Specifies the register pointing to the PIU buffer chain to be transmitted. 
The PIU can be either a request or a response PIU. 


Register notation. 
None. 


Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 
Register 3 is standard. 


»>—(return_code) —________________ 


Function 


Format 
Default 


Remarks 


Specifies the register to receive the return code indicating the success 
or failure of the XIO LINK. A return code of X'00' indicates that the 
XIO LINK started properly. A nonzero code indicates that the station or 
link is in failure mode. 


Register notation. 
None. 


Register 1 is standard. The 8-bit return code is returned in the low- 
order byte of the specified register. 


Function 


Format 
Default 


Specifies the PIU priority based on the value of the virtual route over 
which the BIND traverses for a multiple-entry queue. 


HIGH, MEDIUM, or LOW. 
HIGH. 
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»sMODE=ACTIVE 
»MODE=——ACTIVE 
INACTIVE 
TEST 
Function Checks that the link is in same state as specified. 


When MODE=ACTIVE, normal data and XIDs can be transmitted on the 
link. When MODE=INACTIVE, only load and dump data can be trans- 
mitted. When MODE=TEST, only test data can be transmitted. If the 
link is not active, the return-code register indicates a path error and the 
X!IO LINK function is not performed. If XID exchange with a station is in 
progress, a request to transmit another XID is rejected. 


Format ACTIVE, INACTIVE, or TEST. 
Default ACTIVE. 


, SUPV=NO0 
, SUPV=——NO 
io 
Function Specifies the level in which the issuer is running. 


SUPV=NO specifies that the issuer is running in level 5. SUPV=YES 
specifies that the issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 


»XID=NO 
— as 
~Lyes 
Function Specifies whether data is transferred to a specified link outbound queue. 
lf XID=YES, data is transferred to a specified link outbound queue but is 


not transferred across the link. The PIU keyword contains the address 
of the XID data. 


If XID=NO, data is transferred to a specific link outbound queue and is 
transferred across the link. The PIU keyword contains the address of 
the PIUs to be sent. 


Format YES or NO. 
Default NO. 
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, TAIL=(last_piu_address) 


Function 


Format 
Default 


Remarks 


Specifies the register pointing to the last PIU of a chain of PIUs to be 
sent. 


Register notation. 
None. 


Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 
Register 4 is standard. 


lf MOVE=SINGLE, this keyword is ignored. 


sMOVE=S INGLE 
— ee! 
Ls Inete 


Function 


Format 
Default 
Remarks 


Specifies the number of PIUs sent to the link outbound queue. If 
MOVE=SINGLE, only one PIU ts sent to the link outbound queue. If 
MOVE=PRICHAIN, one or more PIUs are sent to the tail of the link out- 
bound queue. 


PRICHAIN or SINGLE. 
SINGLE. 
lf MOVE=PRICHAIN, you must specify the TAIL keyword. 


ee Pegs Oe 


Function 


Format 


Default 


Specifies a work register, the contents of which may be altered during 
execution of the macro. Specifying such registers makes the macro 
more efficient. 


You can use any or all of the following registers: 1, 2, 3, 4,5, and 7. 
Do not use equated values. 


No work registers. 


Remarks This keyword is valid only when SUPV=YES. 
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Transmission Groups 


This XIO macro passes a PIU from within the path control function (explicit routing) 
to the specified transmission group control block (TGB) for routing to the current 
data link control (DLC). 


Register 0 is not allowed for register parameters. 


Syntax 
ee 10—TG,—(piu_address) ,—TGB=(tgb_address ) 
name 


»MODE=NORMAL 
> 
— ae 
~ LNORMAL 


et hs ae dae ee 
LL WoRKR= (wore regisieo= 
, SUPV=NO 
Ne eee ee EE ae ee ee 
» SUPV=——NO 
— 


Parameters 


>—IG, 


Function Specifies that this XIO passes a PIU to the specified TGB for routing to 
DLC. 


Format IG. 


Default None. 


>—(piu_address) ,——— 


Function Specifies the buffer address of the PIU to be transferred. 
Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. If SUPV=YES, registers 2 and 6 are not 
allowed. The register you specify must not be the same as the register 
specified for the TGB address. Register 3 is standard. 


The PIU is discarded if it is rejected by DLC. 
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»>—TGB=(tgb_address )-——@-@ ——————__ 


Function Specifies the address of the TGB for the routed PIU. 
Format Register notation. 
Default None. 


Remarks Register 1 is not allowed. If SUPV=YES, register 6 is not allowed. 
Register 2 is standard. 


The register you specify must not be the same as the register specified 
for the PIU address. 


»MODE=NORMAL | 
— ae 
~ CNoRMAL 


Function Specifies whether to pass this PIU to DLC depending on the state of the 
transmission group. If MODE=NORMAL, do not pass this PIU to DLC if 
the transmission group is not operative. If MODE=CONTROL, send the 
PIU to DLC regardless of the transmission group state. 


Format NORMAL or CONTROL. 
Default NORMAL. 
Remarks The PIU is discarded if the DLC rejects the PIU. 


Ee WORKR= nee 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default None. 
Remarks Register 6 is not allowed. If SUPV=NO, this keyword is not allowed. 


The register must not be the same as the register specified for the TGB 
address or PIU address. 


» SUPV=NO 
, SUPV=——NO 
= 
Function Specifies the level in which the issuer is running. 


SUPV=NO specifies that the issuer is running in level 5. SUPV=YES 
indicates that the issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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XIOFL—Set or Test an SCB for a Multilink Transmission Group 


The XIOFL macro is issued by data-link-control-level programs for a specified 
station control block (SCB) to correspond with the multilink transmission group func- 
tion. Depending on the mode specified when XIOFL is invoked, NCP: 


e Sets the SCB status to ready and initiates PIU transmission (MODE=READY) 

e Sets the SCB status to not ready (MODE=NOTRDY) 

e Tests the status of the SCB and its associated TGB (MODE=TEST) 

e Tests the SCB to determine its characteristics (MODE=TESTSCB). 
Register 6 must point to a save area that can be overwritten. You must assemble 
the DSECTs for the transmission group control block (TGB) (XCXTTGB), SCB 
(XXCXTSCB), and multilink transmission group control block (FLB) (XCXTFLB) in 
your program. If you use the MODE=READY keyword, you must include an 
EXTRN for CXAFLXS. This macro is expanded to execute inline with your code. 
Register 0 is not allowed for register parameters. 


Note: Do not invoke XIOFL from a compound IF structure. 


Syntax 
eet Nee NOTRDY »—SCB=(scb_register) ,—TIGB=(tgb_register) ,—WORKR=(register) ,——»> 
name READY 
~ --TEST 
TESTSCB 


»>—PIUREG=(piu_address_register) 
, SA=NOTEST 
a SA= —— 
Lest 


Parameters 


»>—MODE= OTRDY ; 
READY 
TEST 
TESTSCB 


Function Specifies that XIOFL is to access the specified control block, check the 
status, then set it, as coded. 


When MODE=READY, XIOFL accesses the specified SCB and checks 
its current status. If the SCB is not ready, XIOFL sets it to ready status. 
If no other SCBs associated with this multilink transmission group are 
currently ready, the macro checks for other conditions and, if they are 
satisfactory, it dequeues a PIU and returns the address in the specified 
PIUREG register. If the SCB is ready, or if other SCBs in the multilink 
transmission group are ready, no action is taken. 


When MODE=NOTRDY, XIOFL accesses the specified SCB and checks 
its current status. If the SCB is ready, XIOFL sets it to not-ready status. 
If the SCB is not ready, no action is taken. 
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Format 
Default 
Remarks 
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When MODE=TEST, XIOFL accesses the specified TGB and checks its 
data link control (DLC) type. If the SCB is attached to a multilink trans- 

mission group, XIOFL sets the Z latch on and sets the C latch off. If the 
SCB is not attached to a multilink transmission group, XIOFL sets the Z 

latch off and sets the C latch on. 


When MODE=TESTSCB and SA=TEST, XIOFL accesses the specified 
SCB and determines if the station is a subarea node, the station is 
associated with the specified TGB, and if the TGB is a multilink trans- 
mission group. If the specified SCB is for a subarea station attached to 
a multilink transmission group, XIOFL sets the Z-latch on and sets the 
C-latch off. If the SCB is not attached to a multilink transmission group, 
XIOFL sets the Z-latch off and sets the C-latch on. 


When MODE=TESTSCB and SA=NOTEST, XIOFL accesses the speci- 
fied SCB and determines whether the station is associated with the 
specified TGB and the TGB is a multilink transmission group. If the 
SCB is attached to a multilink transmission group, XIOFL sets the 
Z-latch on and sets the C-latch off. If the SCB is not attached to a 
multilink transmission group, XIOFL sets the Z-latch off and sets the 
C-latch on. 


READY, NOTRDY, TEST, or TESTSCB. 
None. 


Specify MODE=READY and MODE=NOTRDY only when running in 
level 3 or, if level 3 is disabled, in level 4. 


Warning: MODE=READY destroys register 1, even if it was specified 
by WORKR. 


»>—SCB=(scb_register) ,——_—_________ 


Function 
Format 
Default 


Specifies the register pointing to the SCB to be processed. 
Register notation. 


None. 


>—1GB=(tgb_register) 


Function 
Format 
Default 
Remarks 


Specifies the register containing the address of the TGB to be checked. 
Register notation. 

None. 

This keyword is valid only when MODE=TEST. 
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>—WORKR= (register) ,—_—_________—_ 


Function 


Format 
Default 


Remarks 


Specifies a work register, the contents of which may be altered during 
execution of the macro. The macro uses this register to determine how 
to set the C and Z latches. 


Register notation. 
None. 


You must specify an odd-numbered register. If MODE=TEST, this 
keyword is required; it is optional when MODE=READY or 
MODE=NOTRDY. 


»>—PIUREG=(piu_address_register) ——_—_ _—________________________—_—_——> 


Function 


Format 
Default 
Remarks 


Specifies the register used to return the PIU address if the PIU can be 
sent. 


Register notation. 
None. 


Register 3 is standard. Do not use register 2. If MODE=READY, this 
keyword is required. When MODE=NOTRDY and MODE=TEST, this 
keyword is not valid. 


» SA=NOTEST 
E SA= ——— 
Lest 


Function 


Format 
Default 


Remarks 


SA=NOTEST means that the input SCB is for a subarea station. 
SA=TEST means that the input SCB should be checked to determine 
whether it is for a subarea station. 


TEST or NOTEST. 
NOTEST. 
This keyword is required for MODE=TESTSCB. 
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XPC—Pass a PIU between Data Link Control and Path Control 


The XPC macro passes a path information unit (PIU) between the data link control 
(DLC) function and the specified transmission group within the path control function. 
Data flow direction is specified with the positional keywords OUT and IN. 


OUT transfers the PIU to path control, which performs the routing to the appropriate 
destination. IN indicates that the DLC is going to begin transmission of the PIU 
over a link. IN causes virtual route pacing fields to be set in the PIU if necessary. 


This macro is executed by interrupt level code (SUPV=YES) only. 


Register 0 is not allowed for register parameters. 


Note: The PIU total text count (UIBTCNT) and last buffer address (UIBLBBA) 
must be valid before executing. 


Syntax 
>> ——_—XPCIN7—,, P1U= (piu_register) » —TGB=(tgb_register)——¥__________-_> 
name OUT 


L_ scp- (sch. renisten= 


cote (Sorcreciste “4.3 
,SUPV=YES 
ere 


Parameters 


Tad 


Function Specifies the direction of data flow and the function to be performed. 


OUT specifies that data flow is from the host. The PIU is transferred to 
the transmission group function for routing to the appropriate destination. 
IN specifies that data flow is to the host and that the data link control is 
going to begin transmission of the PIU over a link. IN causes virtual 
route pacing fields to be set in the PIU if necessary. The PIU is not 
transferred to the transmission group, but parameters in the PIU are 
used by the transmission group. 


Format — IN or OUT. 


Default None. 
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»>—PIU=(piu_register) ,——_—________—___——— 


Function Specifies the buffer chain to be routed. 
Format Register notation. 
Default None. 


Remarks If you code OUT, the content of this register is set to O if an error occurs 
and to nonzero if no error occurs. 


Register 6 is not allowed. The register must not be the same as the 
TGB or WORKER register. Register 3 is standard. 


>—TGB=(tgb_register )———________ 


Function Specifies the transmission group control block (TGB) through which the 
PIU is routed. 


Format Register notation. 
Default None. 


Remarks Register 6 is not allowed. Register 2 is standard. The register must not 
be the same as the PIU or WORKR register. 


is SCB= ieebpegisteny 


Function Specifies the station control block (SCB) from which the PIU came. 
Format Register notation. 
Default None. 


Remarks This keyword is necessary if you code OUT and performance collection 
by transmission priority is supported for the station. 


This keyword is ignored when you code IN. 


Register 6 is not allowed. The register must not be the same as the 
PIU, TGB, or WORKR register. Register 5 is standard. 


Function Specifies whether to perform error checking. If ERROR=NOCHECK, no 
checking is done. If ERROR=SETZNC, ERROR=SETZ, or 
ERROR=SETNC, an error indication is returned if the transmission 
group function cannot transfer the PIU because of any of the following: 


e The FID type is not valid or is not FIDO, FID1, or FID4. 
e The PIU length is too short. 
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e The PIU's TH length field does not match the actual PIU length. 
e The subarea address value in the PIU's TH is 0. 


Format SETZNC, SETZ, SETNC, or NOCHECK. 
Default None. 


Remarks If you code IN, this keyword is not allowed. If you code OUT, you must 
code this keyword. 


If you code ERROR=SETZNC, ERROR=SETZ, or ERROR=SETNC and 
no error occurs, the Z latch is set to 0. If an error occurs, the Z latch is 
set to 1 and the C latch is set to 0. 


If any error is detected, the PIU's buffers are released, and the content 
of the PIU register is set to O on return. 


NOCHECK is valid only if the transmission group is not in migration 
mode. Specify NOCHECK only if the same checks have been per- 
formed on this PIU (FID4). 


ork (So eres | 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format Register notation. 
Default No work registers. 


Remarks Register 6 is not allowed. The register must not be the same as the 
PIU or TGB register. 


initials 
, SUPV=YES 
Function Specifies that the issuer is running in an interrupt level. 


Format YES. 
Default YES. 
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XPORTVR—Deliver a PIU to a Virtual Route 


The XPORTVR macro delivers a path information unit (PIU) to virtual route routing 
from the boundary function or physical unit services. The PIU is enqueued to the 
virtual route transmit queue associated with the virtual route identified by the virtual 
route vector table index (VVTI). The VVTI is passed either in the FID4 trans- 
mission header or as a separate parameter. If the virtual route is inoperative, an 
error code is returned. 


Register 0 is not allowed for register parameters. 


Syntax 


>> —__—XPORTVR— (piu_register) »—(return_register )—@§$@—-@@#@-{+—WH— 
name 


es, VVTI= ieeaierer 


L RCB= (reaieter)= 


L WORKR- ( poreeoisien 
, SUPV=NO 
i? =o 
Lys 


Parameters 


>—(piu_register) ,—@ —_ > 


Function Specifies the PIU to be routed. 
Format Register notation. 
Default None. 


Remarks Register 3 is standard. If SUPV=NO, register 1 is not allowed. If 
SUPV=YES, register 6 is not allowed. 


»—(return_register)—_ —_______ 


Function Specifies the register to receive the return code. Return codes are 
X'00' for a PIU successfully enqueued to the virtual route transmit 
queue and X'01' for an inoperative virtual route. 


Format Register notation. 
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Default None. 


Remarks The return code is in the low-order byte of the register. If SUPV=YES, 
register 6 is not allowed. If SUPV=YES, you must specify a return reg- 
ister. If SUPV=NO, a return register is not allowed. Register 1 is 
standard. 


Wile egisren)— 


Function Specifies the register that contains the VVTI. 
Format Register notation. 


Default If you do not code this parameter, the VVTI is assumed to be in the 
FID4 transmission header of the PIU. 


Remarks If you code this parameter, the value of the VVTI specified takes preced- 
ence over any value in the FID4 transmission header. 


lf SUPV=NO, register 1 is not allowed. If SUPV=YES, register 6 is not 
allowed. The VVTI register must not be the same as the register for 
PIU. Register 2 is standard. 


L RcB= inegister)— 


Function Specifies the register that contains the address of the resource's RCB. 
Format Register notation. 
Default None. 


Remarks If SUPV=YES, register 6 is not allowed. If SUPV=NO, register 1 is not 
allowed. The RCB register you specify must not be the same as the 
registers specified for PIU, VVTI, and WORKR. Register 4 is standard. 


Note: This keyword is required for BSB resources. If you do not 
specify RCB, unpredictable results can occur if the virtual route is held. 


» ERROR=SETCNZ 

» ERROR=——SETC 
SETCNZ 
SETNZ 


Function Specifies whether the C latch, the Z latch, or both are to indicate 
whether the PIU was routed. If ERROR=SETCNZ or ERROR=SETC, 
the C latch is set to 1 if the PIU was not routed or to 0 if the PIU was 
routed. If ERROR=SETCNZ or ERROR=SETNZ, the Z latch is set to 0 
if the PIU was not routed or to 1 if the PIU was routed. 


Format SETNZ, SETC, or SETCNZ. 
Default SETCNZ. 
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, WORKR=(work_register) 


Function Specifies a work register, the contents of which may be altered during 
execution of the macro. 


Format You can specify any or all of the following registers: 1, 2, 3, 4, 5, and 7. 
Use register notation. 


Default No work registers. 
Remarks This keyword is valid only when SUPV=YES. 


The registers specified must not be the same as the PIU, RETURN, or 
VVTI register. 


, SUPV=NO 
, SUPV=——NO 
= 


Function Specifies the level in which the issuer is running. SUPV=NO specifies 
that the issuer is running in level 5. SUPV=YES specifies that the 
issuer is running in an interrupt level. 


Format YES or NO. 
Default NO. 
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Chapter 3. Entrances and Exits for User-Written Line Control 


The following sections describe the attachments for user-written line control code in 
NCP code. The table in each section provides: 


The function to be performed 
The name of the module that gives control to user-written code 


The label in the group control block (GCB) where the address of the user- 
written routine is stored 


The level the module runs in 
The register values at the entry point to the user-written routine 
The register values expected by NCP on return from the user-written routine 


The process used to return to NCP, which can be either by the label of an 
immediate NCP return address or an NCP-provided method of returning to NCP 
(EXIT, CALL and SUBROUTINE linkage, BRANCH, and so on). 


The immediate NCP return address is the point at which control should be given 
back to NCP if NCP is to handle the execution of the function. This method can be 
used if user-written code gets control and does not do the function in question. 
Along with the immediate return address, an alternate method of return can be indi- 
cated. The alternate return is usually used if user-written code executes the func- 
tion and no other NCP processing is required for that function. If an immediate 
return address is not specified, the indicated return method should always be used. 


Note: Some of these attachments may not receive control when certain diagnostic 
procedures or traces are active (wrap test, for example). 


XIO Interrupts 


Table 7 (Page 1 of 2). Attachment Details for X/O Interrupts 


Function Called from 
X1O Line CXDCGO0B 
(CXEXIOCD) 


Field 
Name in Register Values at Register Values 
GCB Level Entry Point at Exit Return to NCP 
GCBXIOLN 3 R1 4GCB R2 4UACB immediate at CXENEO1 or 
R2 «UACB R3__Disable use EXIT (if no NCP proc- 
Wasi essing required). Also, incre- 
R3__—s Disable ment level 5 IAR by 2 bytes if 
mask R4 «LGT no errors. 
R4 «4aLGT R5 Work reg- 
R5 = = Work reg- Siet 
ister R6 4PSA/ 
R6 4PSA/ peer 
CCBBAR R7 Work reg- 
R7 Work reg- atl 


ister 
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Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
XIO SETMODE CXDCGOB GCBXIOSM 3 R1 4GCB Ri Work reg- Immediate at CXENEO2 or 
(CXESETMD) R2 «UACB ister use EXIT (if no NCP proc- 
R2 .UACB essing required). Also incre- 
R3 Work reg- ment level 5 IAR by 2 bytes if 
ister R3 ~=Work reg- no errors. 
R44 LGT saa 
R5 Work reg- fs “euee 
ister R5 Work reg- 
R6 4PSA/ ae 
CCBBAR R6 4PSA/ 
R7  CCBCTL sift ial 
CCBTYPE R7 CCBCTL 
(See note 1) tad i 
(See note 2) 
XIO Immediate CXDCGOB GCBXIOIM 3 R1 4GCB R1 Work reg- Immediate at CXENEOS or 
(CXEIMEDC) R2 .UACB ister use EXIT (if no NCP proc- 
R2 .«UACB essing required). Also, incre- 
R3 = Work reg- ment level 5 IAR by 2 bytes if 
ister R3  =Work reg- no errors. 
R44 LGT pre 
R5 Work reg- nec ee 
ister R5 Work reg- 
R6 4PSA/ ae 
CCBBAR R6 4PSA/ 
R7 CCBCTL evebm 
CCBTYPE R7 CCBCTL 
CCBTYPE 
XIO Link CXDCG02 GCBXIOLK 4 R1(0) SVC code R1(0) SVC code Immediate at CXANEO1 or 
Ri(1) comm. flags R1(1) comm. flags Pranch 4 (if no NCP proc- 
essing required). 
R2 4UACB R34 PIU 
R34 PIU R4 ~~ Return 
R4.——- Return address or 
address ee ai 
(See note 3) phate 
R6 4 Save area PiUs 
R7 Entry point R6 «Save 
address area 
Notes: 


1. Level 5 R1(0) contains index into setmode command decode vector table. 


Level 5 R1(1) contains setmode command modifier. 
For NPM Notify setmode, level 5 R5 contains the LKB or SCB address. 
2. For line trace setmode R7 is used as an exception condition indicator. The following values generate sense codes. (Otherwise R7 still contains 


CCBCTL CCBTYPE.) 


X'80'—0801,0000 
X'40'—080C,0007 
X'20'—0801,0000 
X'0C'—080C,0007 
X'04'—0815,0000 


X'02'—0815,0000 (on multipoint subarea node) 


X'02'—084B,0000 
X'01'—0801,0000 


3. R4 in save area has tail pointer if adding chain of PlUs. 
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Box Event Record 


Table 8. Attachment Details for Box Event Record 


Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
Box Event CXABDCRP GCBBERP 1,2, R1 4 GCB R2 4 BER immediate. Use branch R7 (if 
Record 3, R2 «BER R5(1) Return no NCP processing required). 
and code 
4 R4 «Entry point X'00'=BER 
address ay ge 
built, 
R6 4 Save area X'FF'=no 
R7 Return BER 
address R6 a Save 
area 
Timer Interrupts 
Table 9. Attachment Details for Timer Interrupts 
Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
Line Error CXDCG07 GCBERR 3 R2  ~ Return RS .4UACB Immediate at CXCNEO4 (see 
Time-out (CXCCLINT) address note 1) or use TVSRTRN (if 
R6 a Save NCP : ired 
RS 4 UACB ae no processing required). 
R6 a Save area 
R7 ~~ Entry point 
address 
Shoulder-Tap CXDCG07 GCBSTAP 3 R2  ~=Return R5 4UACB Immediate at CXCNEOS (see 
Time-Out (CXCCLINT) address Re aS note 1) or use TVSRTRN (if 
a NCP processing required) 
R5  4UACB area uy P g req 
R6 a Save area 
R7 ~~ Entry point 
address 
Lagging CXDCG07 GCBLAGST 3 R2 Return R5 4 UACB Immediate at CKCNEO2 (see 
Shoulder-Tap (CXCCLINT) address R6 as note 1) or use TVSRTRN (if 
Time-Out oo no NCP processing required) 
R5 4 UACB area : 
R6 4 Save area 
R7 Entry point 
address 
Note: 
1. If the immediate return is used, R6 (Save area) is not used. 
Timer Tick 
Table 10. Attachment Details for Timer Tick 
Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
Display Control-Update CXDCG07 Not used 3 R3_——sCEntrry point R4 CXCCPDSP Use TVSRTRN 
Refresh (Timer Tick) (CXCCPDRS) address address 
R4 CXCCPDSP R6 a Save 
address area 


R6 4 Save area 
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Level 2 and Level 3 Interrupts 


Table 11. Attachment Details for Level 2 and Level 3 Interrupts 


Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
Level 2 CXDCG00 GCBL2 2 R2 4GCB R2 Must point Immediate at CXBNEO1 
Interrupt (CXBTRP2C) R3. SCF/PDF to UACB (error re-entry point only) or 
from PSA using use EXIT (if no NCP proc- 
FINDUACB essing required). 
R4 aLNVT with LNVT 
R6 PSA (R4) 
R3  SCF/PDF 
from PSA 
R4 «aLNVT 
R6 4PSA 
Level 3 CXDCGOD GCBL3 3 Ri 4GCB R2 4UACB Immediate at CKENEO4 or 
interrupt (RNENDR) R2 «UACB R3. SYSL2DEM use EXIT (if no NCP proc- 
equate essing required). 
R3  SYSL2DEM X20! 
equate ( ) 
(X'20') 


Level 3 Router I/S and D/S Interrupt Handler 


Table 12. Attachment Details for Level 3 Router I/S and D/S Interrupt Handler 


Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
Level 3 CA Data CXCCNEO GCBDS 3 R1 a CAVT Use EXIT 
Status Interrupt entry for CA 
with interrupt 
R3(1) High byte of 
TA data for 
CA with 
interrupt 
R5 4GCB 
R6 «Save area 
Level 3 CA Initial CXCCNEO GCBIS 3 R1 4 CAVT Use EXIT 
Select Interrupt entry for CA 


with interrupt 


R3(1) High byte of 
TA data for 
CA with 
interrupt 


R5 4GCB 


R6 4 Save area 
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Channel Errors 


Table 13 (Page 1 of 3). Attachment Details for Channel Errors 


Field | 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
Set up all ESCs owned by CXCAERP GCBLIERP 1 Ri CERSTATE Ri CERSTATE Return address 
user code on this CA to be ERP seq. Erp seq. passed in R7 
cleared of traffic so CA can flags flags 
be ceabred: R2 4CER R2 4CER 
R3(1) NEORCTL R4 aCAVT 
(X'24') entry 
R4 aCAVT R6 4 Save 
entry area 
RS User entry 
point 
R6 4 Save area 
R7 Retum 
address 
Handle I/S interrupt for ESCs CXCAERP GCBLIERP 1 Ri IOHIN Use EXIT 
owned by user code, reset it, X'00' 
then exit. R2 4CER 
R3(1) NEOL3IS 
(X'2C') 
R4 aCAVT 
entry 
RS User entry 
point 
R6 4 Save area 
System reset or selective CXCAERP GCBLIERP 1 R1 !OH IN R1 IOHIN Return address 
reset. Attempt to disable CA. X'00' X'00' passed in R7 
R2 .4CER R2 4CER 
R3(1) NEOSYSR R4 aCAVT 
(X'30') entry 
R4 aCAVT R6 4 Save 
entry area 
R5 User entry 
point 
R6 4 Save area 
R7 Retum 
address 
Handle D/S interrupt for ESC CXCAERP GCBL1ERP 1 R1 IOHIN Use EXIT 
owned by user code, reset it, X'00' 
then exit. R2 CER 
R3(1) NEOL3DS 
(X'28') 
R4 «4CAVT 
entry 


R5 User entry 
point 
R6E 4 Save area 
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Field 
Name in Register Values at Register Vaiues 
Function Called from GCB Level Entry Point at Exit Return to NCP 
Clean up all logical and phys- CXBCAPBF GCBLIERP 1 R2 4CAVT R2 4CAVT Return address 
ical paths to this CA so no R3(1) NEODSAB R4 aLiB passed in R7 
more traffic is routed through (X'20') 
it. R6 4 Save 
R4 4L1B area 
R5 User entry 
point 
R6 4 Save area 
R7 Retum 
address 
Ground fault error processing, CXBL1PM(372X) GCBLIERP 1 Ri = CA error reg- R1 CAerror Return address 
I/S flag is on. (CXBADAP) ister register passed in R7 
R2 4AST or AIT R2 4AST or 
R3(1) NEOCBIS oe 
(X'0C') R4 4L1B 
R4 4L1B R6 4 Save 
R5 ~_—User entry at 
point 
R6 4 Save area 
R7 Retum 
address | 
Ground fault error processing, CXBL1PM(372X) GCBLIERP 1 Ri = CA error reg- R1 CAerror Return address 
D/S flag is on. (CXBADAP) ister register passed in R7 
R2 4AST or AIT R2 4AST or 
R3(1) NEOCBDS ae 
(X'10') R4 4L1B 
R4 4L1B R6 4 Save 
R5 ~——User entry aes 
point 
R6 4 Save area 
R7 Retum 
address 
Intemal CA error, I/S flag is CXBL1PM(372X) GCBLIERP 1 R1 =A error reg- Ri  CAerror Return address 
on. (CXBADAP) ister register passed in R7 
R2 4AST or AIT R2 4AST or 
R3(1) NEOCIIS a 
(X'14') R4 41L1B 
R4 4L1B R6 4 Save 
RS ~—_—-User entry ae 
point 
R6 4 Save area 
R7 Retum 
address 
Handle interrupt CA error CXBL1PM(372X) GCBL1ERP 1 R1 CA error reg- R1 CA error Return address 
processor (CXBADAP) ister register passed in R7 
R2 4CER R2 «CER 
R3(1) NEOCIDS R4 4L1B 
eee R6 4 Save 
R4 41L1B area 
R5 ~=—User entry 
point 
R6 4 Save area 
R7 Return 
address 
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Table 13 (Page 3 of 3). Attachment Details for Channel Errors 


R6 a4 Save area 


R7 Retum 
address 


Field 
Register Values at Register Values 
Function Called from Entry Point at Exit Return to NCP 
IOH input error processor CXBADAP R1 CA error reg- R1 CAerror Return address 
CXBADAPA ister register passed in R7 
R2 4AST or AlT R2 «AST or 
R3(1) NEOCIL3 al 
(X'1C') R4 4118 
R4 4L1B R6 4 Save 
RS User entry ae 
point 
R6 4 Save area 
R7 Retum 
address 
10C-detected AIO error proc- CXBL1PM(372X) R1 Work reg- R1 Work reg- Return address 
essing (CXBAIO) ister ister passed in R7 
R2 .4CAB R2 4CAB 
R3(1) NEOAIO R4 4L1B 
(X'04") RG 4 Save 
R4 4L1B area 
R5 User entry 
point 
R6 4 Save area 
R7 Retum 
address 
CA PIO error processor CXBL1PM(372X) R1 CAerror reg- R1 CAerror Return address 
(CXBPIO) ister register passed in R7 
R2 AST or AIT R2 4AST or 
R3(1) NEOPIO me 
(X'08') R4 4L1B 
R4 4L1B R6 «Save 
RS User entry alee 
point 
R6 «4 Save area 
R7 Retum 
address 
CA AIO error processor CXBL1IPM R1 —s Interrupt R1 Interrupt Return address 
requests requests passed in R7 
R2 Work reg- R2 Work reg- 
ister ister 
R3(1) NEODSAB R4 41L1B 
ine) RE «4 Save 
R4 4L1B area 
R5 ~~ User entry 
point 


Note: R3(1) contains a code indicating the reason the routine was called. 
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Table 14. Attachment Details for General User-Code Functions 


Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to NCP 
User system reset CXDCG06 GCBRESET 3 R1 4GCB R1 4GCB At CYPNRSET 
routine (CXCAIOSS3) R2 aCAE R2 aCAE 
R4 4CAB R4 4CAB 
R6 4 Save area R6 4 Save 
area 
R5 = Set for IOH 
OUT 7 to 
CA Control 
Register 
R6 4 Save 
area 
User queue scan CXDCG06 GCBSCAN 1 R1 .4GCB R1 4GCB At CYPNSTRT 
couune (CRON) R6 4 Save area R6 4 Save 
area 
User queue scan CXCAERP GCBSCAN 3 Ri 4GCB Ri «4GCB At CYPNSTRT 
routine R6 4 Save area R6 4 Save 
area 
User RECMS/NMVT CXDKINP GCBRNBLD 5 R2 4LKB Use CALL and SUB- 
build routine ROUTINE linkage 
User global interface CXANEOR Not used 1, 2, R1 4NEOG R6 4 Save Return address in R7 
routine 3, parameter area (PERFORM-ROUTINE 
and status entry linkage is recom- 
: R6 4 Save area mended): 
R7 Retum 
address 
User initialization CXFINITC Not used 1 R3 ~——User entry Branch to address in 
routine point R6 
R6 Retum 
address 
User accounting notify CXJQNNOT Not used 5 R1 4 Reason R6 «Save NEOAXT 
Pune X'0001'—Enabled aon 
X'0002'—Solicit 
X'0003'—Disabled 
R6 4 Save area 
User accounting notify CXJQNNAT Not used 5 R1 4 Reason R2 = 4 Buffer NEOAXT 
routine X'0004'—Request with rat 
user accounting eubtuen: ne 
parameter CV areas et 
R2 4 Buffer for 
CV R6 4 Save 
area 
R6 4 Save area 
User accounting notify CXJQNLSN Not used 5 R1 «Reason R2 4 Buffer NEOAXT 
routine X'0005'—Change from input 
user accounting R6 «4 Save 
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parameter CV 


R2 4 Buffer for 
CV 


R6 4 Save area 


area 
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NCP Code Functions 


Table 15 (Page 1 of 2). Attachment Details for Using NCP Code Functions 


Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to User 
Entry point CKERETRY User routine Not used 3 R2 4ACB (Xmit No retum to user No return to user 
(Level 3 X21 Call Request if FDX) from this routine 
Retry) R5(1) Completion 
codes fieid 
(CCBCMPCD) 
R6 4PSA 
R7(1) Line type 
(CCBTYPE) 
Entry point CKERCVNT (FDX User routine Not used 3 R1(1) (See note 2) R2 4 ACB (Rev Returns to 
jester Initialization). R2 4 ACB (Xmit if FDX) address in R4 
iseemnote-t) if FDX) R3 None 
R3 None (See note 
(See note 3) 3) 
R4 — Retum i pie , 
address ' ee 
R5 None 
(See note 3) R64 Save 
area 
R6 S 
*9aVve area R70) Control 
R7(0) Control flags flags 
(CCBCTL) (CCBCTL) 
R7(1) Line type R7(1) Line type 
(CCBTYPE) (CCBTYPE) 
Entry point CXEXMTNT (lIni- User routine Not used 3 Ri Retum R2 4ACB Returns to 
tiate a Transmission) address (XMT Leg if address in R1 
R2 ACB non) 
R3 None = pa ' 
(See note 4) : re 
R4 Address to 
store in ne; “have 
CCBL3 (FDX one 
XMT Leg R7(0) Control 
Only) flags 
R6 4 Save area (CCBCTL) 
R7(0) Control flags R7(1) puna 
(CCBCTL) ( ) 
R7(1) Line type 
(CCBTYPE) 


(See note 5) 
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Table 15 (Page 2 of 2). Attachment Details for Using NCP Code Functions 


Field 
Name in Register Values at Register Values 
Function Called from GCB Level Entry Point at Exit Return to User 
Entry point CXBDQACB User routine Not used 2 R2 4UACB R1 Work reg- Returns to 
(Queue UACEB to Level 3 R4  Retum ister address in R4 
CCPQ; used only when you 
code ROUTINE=YES on the eames ne ipa 
POSTUACB macro). 
Notes: 
1. Routine CXERCVNT performs no processing unless CCBL2=CCBDLIDL. 
2. For FDX receive leg initialization, R1(1) contains the following parameters: 
Lei oa An RR with poll is to be transmitted (set for an HPTSS line only) 
pias. Contes Reserved 
Pe are Reserved 
eel eee Reserved 
rome ary Reserved 
Saree Set “answer requested” in PSA Mod 
emery Reserved 
bee ews 1 Reserved 


3. R3 and R5 are saved on entry, restored on exit, and used as work registers. 
4. R3 is saved on entry, restored on exit, and used as a work register. 
5. 24(R6) contains a pointer to buffers to be transmitted for XID, TEST, FRMR, and I-FRAMES. 
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Chapter 4. NDF Utility Directory 


This chapter contains General-Use Programming Interface and Associated Guid- 
ance Information. 


This chapter describes the SSP NDF internal utilities for user-written generation 
applications. These utilities provide functions such as manipulating strings, passing 
link-edit statements, and creating error messages. These utilities are called using 
the transfer vector table (XVT), which is described in detail in NCP and SSP 
Customization Guide. 


In this chapter, the descriptions of the utilities are arranged alphabetically. The 
description of each utility includes the function of the utility, a description of its 
parameters, and one or more examples. 


NDF Internal Utilities Grouped by Function 
The NDF internal utilities provide the following general functions: 


Validate character and number strings 

Print error messages in the generation report 
Pass link-edit statements to NDF 

Generate table assembly source 

Trace utilities and their parameters 
Manipulate strings 

Convert number strings to numbers 

Process a generation definition 

Search the SYSLIB data set for a member. 


The NDF internal utilities are grouped by function in the following list. 


Validate character and number strings: 


ICNCVLAB Validate statement symbols. 
ICNCVRNG _ Validate a value range. 
ICNCVTOK Validate a string. 

Print error messages to the generation report: 


ICNERPST Post an error message. 


Pass link-edit statements to NDF: 
ICNLEPTN Post a link-edit statement. 


ICNLEPTS Post link-edit statements to create a separate load module from 
table 1. 

ICNLEPT2 Post link-edit statements to create a separate load module from 
table 2. 


Generate table assembly source: 


ICNOBPUN Punch table 1 assembly source. 
ICNOBPU2 Punch table 2 assembly source. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 449 


Utilities Grouped By Function 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


Trace utilities and their parameters: 


ICNRPFMT 
ICNRPINF 

INCRPPBT 
ICNRPPCH 
ICNRPPCX 
ICNRPPFX 
INCRPPHX 
ICNRPPNM 
ICNRPTRC 


Print a formatted string. 

Print a default or inheritance message. 
Trace a Boolean flag. 

Trace a standard string. 

Trace a nonstandard string. 

Trace a decimal number. 

Trace a hexadecimal number. 

Trace the value of a number. 

Trace procedure entry or exit. 


Manipulate strings: 


ICNSMAFT 
ICNSMALN 
ICNSMBEF 
ICNSMCAT 
ICNSMCMP 
ICNSMFMT 
ICNSMFND 
ICNSMLEN 
ICNSMPLS 
ICNSMSTD 
ICNSMSUB 
ICNSMTRM 


Return the substring following the target string. 
Return the actual length of a string. 

Return the substring before the target string. 
Concatenate strings. 

Compare strings. 

Format a value into a string. 

Find a string. 

Determine a string's logical length. 

Convert a standard string to a nonstandard string. 
Convert a nonstandard string to string standard representation. 
Return a substring of a specified length. 

Trim trailing blanks from a string. 


Convert number strings to numbers: 


ICNTCBTA 
ICNTCBTC 
ICNTCDEC 
ICNTCDTC 
ICNTCDTH 
ICNTCHEX 


Convert a bit to an arithmetic number. 

Convert a bit to a decimal string. 

Convert a decimal string to a number. 

Convert a number to a decimal character string. 
Convert a number to a hexadecimal string. 
Convert a hexadecimal string to a number. 


Process a generation definition: 


ICNIPGKI 
ICNUSDTG 
ICNUSGKI 
ICNUSKAD 
ICNUSKRP 
ICNUSNEW 
ICNUSRNA 
ICNUSSTA 
ICNUSSTC 
ICNUSSTI 
ICNUSSTS 
ICNUSTAD 
ICNUSTRT 
ICNUSTUP 


Get user-coded keyword value. 

Get date and time of generation. 

Get keyword values. 

Add a keyword to the generation definition. 
Replace a keyword in the generation definition. 
Get the NEWNAME value. 

Get network addresses. 

Activate a group of statements. 

Add a comment to a generated statement group. 
Set an insertion point for a statement group. 
Save a definition statement. 

Add an entry to the table storage facility. 

Get data from the table storage facility. 

Update the table storage facility. 


Search the SYSLIB data set for a member: 


ICNUSLIB 
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NDF Internal Utility Descriptions 


The descriptions of the NDF internal utilities have the following general form: 


XVT Location Parameters 


X'7C! in_number 
out_decstring 


In this description, XVT Location is the offset in the transfer vector table (XVT) 
where the utility's start address is located. Parameters lists the parameters passed 
to the utility. All parameters are required unless enclosed in square brackets [ ]. 
Any utility that has in_argx as a parameter uses a variable-length parameter list. A 
description of the parameters follows the table. 


The description of each utility includes a brief example of how to call the utility. 
These examples use a symbolic format to demonstrate the order of parameters and 
their values. Actual utility calls are written in OS/VS, DOS/VSE, or VM/370 Assem- 
bler Language or another equivalent language. 


For more information on variable-length parameter lists, the linkage conventions for 


utility calls, and the NDF string handling system, refer to Chapter 4, “Creating and 
Using NDF Generation Applications,” in NCP and SSP Customization Guide. 
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ICNCVLAB—Validate Statement Symbols 


The ICNCVLAB utility validates a statement symbol and returns a status code. It 
tests for proper length, ensures that the characters are valid, and checks that the 
statement symbol has not already been defined in the generation definition. If all 
these results are positive, ICNCVLAB sets out_status to 0; otherwise, out_status 
contains a nonzero return code, which Is explained below. If the symbol is not valid 
and in_ncp_print is set to 1, NDF prints an error message. 


The utility saves all valid symbols to make sure that future symbols do not duplicate 
a value. It also records the symbol and the line number of the generation definition 
where the statement begins in a data structure for later use in creating the cross- 
reference. 


Use ICNCVLAB to validate statement symbols for user-defined statements only. 
Do not use ICNCVLAB to validate statement symbols for NCP statements; NDF 
also uses ICNCVLAB, and errors for duplicate statement symbols would result. 


Syntax 
XVT Location Parameters 
X'Q4' in_symbol 
in_ncp_print 
out_status 
Parameters 
in_symbol 


Function Specifies the statement symbol to be validated. 


Format  Sixteen-character string in string standard representation. 


in _ncp_print 


Function Specifies whether ICNCVLAB should generate an NCP error 
message if the symbol is not valid. 


Format One-byte flag. Bit 0 is checked. 


Remarks lf in_ncp_print is set to 1, NDF prints an error message if the 
symbol is not valid. 
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Example 


out_status 


ICNCVLAB 


Function Specifies a return code. 


Format = Fullword integer. 


Remarks The status values are as follows: 


Status 
Value 


Meaning 

Symbol passed all validity checks. 

Symbol has a length of 0. 

Symbol is longer than 8 characters. 

First character is not a letter, @, or #. 

Symbol is too long and the first character is not valid. 
First character is $. 

Symbol is too long and the first character is $. 


A character other than the first character is not a letter, digit, 
@, #, or $. 


Symbol is too long, and a character other than the first is not a 
valid character. 


First character and some other character are both not valid 
characters. 


Symbol is too long and the first and some other character are 
not valid characters. 


First character is $ and some character other than the first is 
not a valid character. 


Symbol is too long, the first character is $, and another char- 
acter is not a valid character. 


Symbol is a duplicate. 


CALL ICNCVLAB('SYMBO %','1'B,OUTSTAT) 


Because the symbol is valid, OUTSTAT is set to 0 by ICNCVLAB. 
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ICNCVRNG—Validate a Numeric String 


The ICNCVRNG utility validates a number string and returns a value and a status 
code of 0 if the value meets a conversion check and falls within the specified 
minimum and maximum values. If the value is not valid and the print-error flag is 
set to 1, NDF generates an error message. 


ICNCVRNG validates both decimal and hexadecimal number strings. 


Syntax 


XVT Location Parameters 


X'08' in_keyname 
in_value 
in_min 
in_max 
in_type 
in_ncp_print 
out_value 
out_status 


Parameters 
in_keyname 


Function Specifies the current keyword name. It is used in any error mes- 


sages generated by ICNCVRNG. 


Format  Sixteen-character string in string standard representation. 


in_value 


Function Specifies the number string to be checked. 


Format A string in string standard representation. The maximum length is 
256 characters. 


in_min 
Function Specifies the minimum allowable value of in_value after it is con- 


verted. 


Format = Fullword integer. 


Ln_max 


Function Specifies the maximum allowable value of in_value after it is con- 
verted. 


Format = Fullword integer. 
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in_ type 


Function 
Format 


Remarks 


in_ncp_print 


Function 


Format 


Remarks 


out_value 


Function 


Format 


out_status 


Function 
Format 


Remarks 


ICNCVRNG 


Specifies the type of value to verify. 
Fullword integer. 


An in_type value of 4 indicates a hexadecimal number; 5 indicates 
a decimal number. 


Sets the flag to indicate whether ICNCVRNG should generate an 
error message if the value is not valid. 


One-byte flag. Bit 0 is checked. 


If in_ncp_print is 0, NDF will not print an error message if a conver- 
sion or range-check error occurs. 


Returns the converted and validated value. 


Fullword integer. 


Returns the status code. 
Fullword integer. 


The out_status parameter returns 0 if the value passes the range 
and validity checks; otherwise, it returns a status value specifying 
the error, as follows: 


Status 
Value Meaning 
0 Value passes all validity checks. 
1 in_type is not valid. 
9 in_value is not within the required range. 
21 The conversion of in_value failed. 
56 in_value is a null string. 
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Example 
CALL ICNCVRNG('KEY1%','12%',10,15,5,'1'B,OUT_VALUE,OUT_ STATUS) 


Because in value is within the range and is a valid number, out_value is set to 12 
and out_status is set to 0. 
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ICNCVTOK 


ICNCVTOK—Validate a Character String 


The ICNCVTOK utility validates a character string. It returns a O status code if the 
string meets the length and character tests. If the string is not valid and the 
in_ncp_print flag is set to one, ICNCVTOK generates an NCP error message. 


Syntax 


XVT Location 
X'0C' 


Parameters 
in_keyname 


Function 


Format 
in_ string 
Function 


Format 


in_max 


Parameters 
in_keyname 
in_string 
Ln_max 
in_type 
in_ncp_print 
out_status 


Specifies the current keyword name. It is used in any error mes- 
sages ICNCVTOK generates. 


Character string in string standard representation. The maximum 
length is 16 characters. 


Specifies the string to be checked. 


Character string in string standard representation. The maximum 
length is 256 characters. 


Function Specifies the maximum number of characters the string may have. 


Format 


Fullword integer. 
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Function Specifies the type of string to verify. 


Format = Fullword integer. 


Remarks in_type can have the following values: 


Value 
1 


in_ncp_print 


Meaning 


Assembler string check. String cannot start with $, or the 
digits 0 to 9. 


File name string check. String cannot start with the digits 0 to 
9. 


Any type. Strings can start with any character. 


Hexadecimal string check. String can consist only of the char- 
acters A to F and 0 to 9. This check is used to validate literal 
data sequences for CUID and any other polling operations that 
require hexadecimal strings longer than 8 characters. 


Function Contains the flag to indicate whether NDF should generate error 
messages if the string is not valid. | 


Format One-byte flag. Bit 0 is checked. 


Remarks If in_ncp_print is set to 1, NDF issues an error message if the 
string is not valid. 


out_status 


Function Returns the status code from ICNCVTOK. 


Format —_Fullword integer. 


Remarks (Qut_status returns 0 if the string is valid, or it returns a nonzero 
code indicating the error if the string is not valid. The status values 
are as follows: 


Status 
Value 
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Meaning 

String passes all validity checks. 

String has a length of 0. 

String is longer than 8 characters. 

String character is not a letter, @, or #. 

String is too long, and the first character is not valid. 
String character is $. 


String is too long and the first character is $. 
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32 


Example 


ICNCVTOK 


Meaning 


A character other than the first character is not a letter, digit, 
@, #, or $. 


String is too long, and a character other than the first is not a 
valid character. 


First character and some other character are both not valid 
characters. 


String is too long and the first and some other character are 
both not valid characters. 


The first character is $, and some character other than the first 
is not a valid character. 


String is too long, the first character is $, and another char- 
acter is not a valid character. 


In_type was not 1, 2, 3, or 4. 


CALL ICNCVTOK('KEY1%', 'STRING%',8,1, '1'B, OUTSTAT) 


The string meets the length requirement, and is a proper assembler string (in_type 
is 1, indicating an assembler string), so out_status is set to 0. 
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ICNERPST prints an error message in the NDF listing. It also does error summary 
processing, such as incrementing error counts and formatting error messages. 


XVT Location 
X'10' 


Parameters 
in_severity 


Function 
Format 


Remarks 
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Parameters 


in_severity 


in_msg 


in_argx 


Contains the error severity code. 


Fullword integer. 


Table 16 shows the numeric value of the severity codes and their 
meanings. The table also shows the severity message associated 
with each severity value. Note that a severity of 4 or greater causes 
NDF to validate the generation only, and NDF does not perform any 
further processing. 


Table 16. Error Message Severity Codes 


Severity 


Message 


Info | 


Warning 


Error 


Ten 


Severe 


Fatal 


Severity 
Value 


0 


10 


12 


16 


Meaning 


Informational message only. No programmer 
action is required. 


An error has occurred for which NDF has taken 
corrective action by assuming a default keyword 
value or by ignoring the value supplied. The 
generation process is terminated after validation 
of the generation definition. 


A user error has occurred for which NDF cannot 
assume a value or ignore the value supplied. 
The generation process is terminated after vali- 
dation of the generation definition. 


A fatal user error has been detected. The gen- 
eration process is terminated. 


A system error has occurred. NDF produces a 
procedure traceback. The generation process 

is terminated after validation of the generation 

definition. 


A fatal system error has occurred. A procedure 
traceback is printed and the generation process 
is terminated. 
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in_msg 


Function Contains the error message. 


Format Character string in string standard representation. The maximum 
length is 256 bytes. 


Remarks The error message has the following format: 
ICN234I Body of message 


The body of the message can contain control codes to control the 
insertion of text from the variable parameter list in_argx. For infor- 
mation about control codes, see “NDF String Handling” in NCP and 
SSP Customization Guide. 


in_argx 


Function Provides a variable number of filler parameters that are either 
inserted into the error message or used to control the formatting of 
the error message. 


Format __ Variable-length parameter list. 


Example 


CALL ICNERPST(8,'ICN999E /S = /F IS NOT VALID, /S IS ASSUMED%', 
'USRSTMT1%' , 3745, 'UNIT%') 


The control codes insert the arguments into the message text to produce the fol- 
lowing message: 

*ERROR* ICN999E 8 USERSTMT1 = 3745 IS NOT VALID, UNIT IS ASSUMED 
The *ERROR* and severity value 8 are generated by ICNERPST from the value of 
in_severity. The message is generated as follows: 


1. Control code /S gets the first subargument of in_argx and inserts it after the 
message number. 


2. The first part of the text in the call is printed (=). 
3. Control code /F gets the fullword integer 3745 and inserts it. 
4. Control code /S gets the last subargument of in_argx ('UNIT%'). 


5. The rest of the text in the call is printed. 
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ICNIPGKI—Get a User-Coded Keyword Value 


ICNIPGKI gets the user-coded value for any keyword on the current statement. 


Syntax 
XVT Location Parameters 
X'CO' key_name 
key val 
key_len 
parsed 
key_cnt 
Parameters 
key_name 
Function Contains the name of the keyword whose value you are retrieving. 
Format Character string in string standard representation. 
key_val 
Function Returns the value entered for the specified keyword. 
Format Character string in string standard representation. 
Remarks If you do not code the keyword, key_val contains a null string 
(*%'), 
key_len 
Function Returns the length of key val. 
Format Fullword integer. 
Remarks If you do not code the keyword, key_len is 0. 
parsed 
Function Contains parsed representation of key_val; used for multiple subop- 
erands. 
Format Array with the following structure: 
DCL 1 parsed(100) 
Remarks Characters such as parentheses are not included in parsed. 
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key_cnt 


Function Returns the number of suboperands contained in parsed. 
Format = Fullword integer. 


Remarks If you do not code the keyword, key cnt is 0. 


Examples 
CALL ICNIPGKI('LNCTL%',KEY_VAL,KEY_LEN,PARSED,KEY_CNT) 


If you code LNCTL=SDLC, ICNIPGKI returns the following values: 


key_val=SDLC% 
key_len=4 
parsed val_len(1)=4 
val_ptr(1) points to SDLC 
key_cnt=l 


CALL ICNIPGKI('USERID%',KEY VAL,KEY_LEN,PARSED, KEY CNT) 


If you code USERID=5668854 , ECLRBDT,NORECMS,U,ECLNMVX, ICNIPGKI returns the fol- 
lowing values: 


key_val=' (5668854, ECLRBDT, NORECMS ,U, ECLNMVX) %' 
key_len=35 
parsed val_len(1)=7 

val_ptr(1) points to 5668854 
parsed val_len(2)=7 

val_ptr(2) points to ECLRBDT 
parsed val_len(3)=7 

val_ptr(3) points to NORECMS 
parsed val_len(4)=1 

val_ptr(4) points to U 
parsed val_len(5)=7 

val_ptr(5) points to ECLNMVX 
key_cnt=5 
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ICNLEPTN—Post a Link-Edit Statement 


With the ICNLEPTN utility, you can post link-edit statements. The statements 
determine the construction of the controller load modules. 


ICNLEPTN posts the statements to a specific list, called a cluster. There is one 
cluster for each block of storage allocated for user-written controller code. Each 
cluster corresponds to GENEND keywords, as shown: 


Cluster ID GENEND Definition Statement Keywords 
1 SRCLO 


2 Should not be used. If used, the object modules are placed in the lower 
64KB of controller storage. 


3 INCL2LO and ORDL2LO keywords 

4 INCL2HI and ORDL2HI keywords 

5 INCLO and ORDLO keywords 

6 SRCHI, INCHI, and ORDHI keywords 
7 INCINIT and ORDINIT keywords 

8 Reserved 

9 KEYOINC and KEYOORD keywords 


10 REPLACE keywords for each control block assembled in the table 1 
assembly 


You must post the link-edit statements in the order defined for the CSECTs in the 
load module. Your generation application must post its link-edit statements before 
or during GENEND statement processing. 


Note: If your generation application posts link-edit statements to cluster 6, it must 
not post them until after NDF has completed processing the BUILD statement. 


Syntax 
XVT Location Parameters 
X'14! in_cluster_id 
in_mvs 
tn_le_command 
Parameters 


in_cluster_id 


Function Identifies the cluster to which the link-edit command is posted. 


Format —_Fullword integer. 
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in_mvs 


Function Specifies the operating system this statement is used for. 


The flag in_mvs indicates that the link-edit is for either MVS or VM, 
not VSE. ICNLEPTN posts statements only if the link-edit type indi- 
cated by the flag matches the type specified on the TYPSYS 
keyword on the BUILD definition statement. 


Format = Fullword integer. 
Remarks A value of 0 indicates MVS or VM; a value of 1 indicates VSE. 


tn_le_command 


Function Specifies the link-edit statement to be posted. 


Format Character string in string standard representation. It must be a valid 
link-edit statement. 


Example 
CALL ICNLEPTN(1,0, ‘INCLUDE MYPDS (MEM) %') 


This call posts the control statement INCLUDE MYPDS(MEM) to the first cluster if the 
system type is MVS or VM. 
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ICNLEPTS—Post Link-Edit Statements to Produce a Separate Load 


Module from Table 1 


Syntax 


The ICNLEPTS utility posts link-edit statements that control the generation of a load 
module from table 1 that is separate from the NCP controller load module. It can 
generate NCP and UWGA REPLACE cards and all other link-edit statements 
(INCLUDE, ORDER, ENTRY, NAME, and so on). 


For different operating systems, your utility must meet the following requirements: 


e For MVS and VM, your utility must post the following link-edit statement as its 
first link-edit command in order to include code added to the table assembly 


Input: 


INCLUDE SYSPUNCH(ICNTABL1) 
This is for code added to table 1. 


e For MVS and VM, you must post REPLACE statements for all CSECTs 
punched into the table assemblies. 


e For VSE, you must post as the first link-edit statement PHASE modname,+0 where 
modname is the name of your load module. 


Note: This utility does not replace the functions of ICNLEPTN, which posts link- 
edit statements for code that resides in NCP. 


XVT Location 
X'B4' 


Parameters 
in_uwga_name 


Function 


Format 


in_typsys 
Function 


Format 


Remarks 
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Parameters 


in_uwga_name 
in_typsys 
in_replace 
in_le_card 


Specifies the name of a load module as coded on the USERGEN 
keyword of the OPTIONS definition statement. It is used for diag- 
nostic purposes by NDF. | 


Sixteen-character string in string standard representation. 


Identifies the operating system for which this link-edit statement is 
applicable. 


Fullword integer. 


A value of 0 indicates MVS or VM; a value of 1 indicates VSE. 
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in_replace 


Function 
Format 


Remarks 


in_le_card 


Function 


Format 
Remarks 


Example 


ICNLEPTS 


Identifies whether this is a REPLACE statement. 
Fullword integer. 


A value of 0 indicates that this is not a REPLACE statement: a 
value of one indicates that it is. 


Specifies the card image of the link-edit statement to be posted. 


String standard representation. The maximum length is 256 charac- 
ters. 


The card image is expected to be in valid link-edit statement format. 


CALL INCLEPTS('UWGA1%',0,0,' INCLUDE MYPDS(MEMBER)%') 


The call posts the link-edit statement for MVS or VM for a separate load module. 
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ICNLEPT2—Post Link-Edit Statements to Produce a Separate Load 
Module from Table 2 
The ICNLEPT2 utility posts link-edit statements that control the generation of a load 
module from table 2 that is separate from the NCP controller load module. It can 


generate NCP and UWGA REPLACE cards and all other link-edit statements 
(INCLUDE, ORDER, ENTRY, NAME, and so on). 


This utility may not be used by VSE users, since NDF running under VSE punches 
all its table assembly code to table 1. For MVS and VM, your utility must meet the 
following requirements: 


¢ Post the following link-edit statement as its first link-edit command in order to 
include code added to the table assemble input: 


INCLUDE SYSPUNCH(ICNTABL2) 
This is for code added to table 2. 
e Post REPLACE statements for all CSECTs punched into the table assemblies. 


Note: This utility does not replace the functions of ICNLEPTN, which posts link- 
edit statements for code that resides in NCP. 


Syntax 
XVT Location Parameters 
X'CC' in_uwga_name 
in_typsys 
in_replace 
in_le_card 
Parameters 


in_uwga_name 


Function Specifies the name of a load module as coded on the USERGEN 
keyword of the OPTIONS definition statement. It is used for diag- 
nostic purposes by NDF. 


Format  Sixteen-character string in string standard representation. 


un_typsys 


Function Identifies the operating system for which this link-edit statement is 
applicable. 


Format —_Fullword integer. 


Remarks A value of 0 indicates MVS or VM; a value of 1 indicates VSE. 
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in_replace 


Function 
Format 


Remarks 


in_le_card 


Function 


Format 


Remarks 


Example 


ICNLEPT2 


Specifies whether this is a REPLACE statement. 
Fullword integer. 


A value of 0 indicates that this is not a REPLACE statement: a 
value of 1 indicates that it is. 


Specifies the card image of the link-edit statement to be posted. 


String standard representation. The maximum length is 256 charac- 
ters. 


The card image is expected to be in valid link-edit statement format. 


CALL INCLEPT2('UWGA1%',0,0,' INCLUDE MYPDS (MEMBER) %') 


The call posts the link-edit statement for MVS or VM for a separate load module. 
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ICNOBPUN—Punch Table 1 Assembly Source 


The ICNOBPUN utility produces an assembly record to go into the table 1 
assembly source. The record is generated from the input string and from the 
parameters in the argument string. 


Note: You must create your own CSECT for your user control blocks. You should 
not use $SRCLO or $SRCHI for control blocks generated using ICNOBPUN. 


Syntax 
XVT Location Parameters 
X'18' in_control_str 
in_argx 
Parameters 
in_control_string 
Function Contains a string of string-standard-representation control codes that 
control the construction of the assembly record from the values in 
the parameter list in_argx. 
Format Character string in string standard representation. The maximum 
string length is 256 characters. 
Remarks For information about control codes, see “NDF String Handling’ in 
NCP and SSP Customization Guide. 
in_argx 
Function Contains the parameter list of elements that are used to construct 
the assembly record. 
Format Variable-length parameter list. 
Example 


CALL ICNOBPUN('USER% /T5 /S', 'CSECT%') 


This call produces the following assembly record: 
USER CSECT 
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ICNOBPU2—Punch Table 2 Assembly Source 


The ICNOBPU2 utility produces an assembly record to go into the table 2 assembly 
source. The record is generated from the input string and from the parameters in 
the argument string. 


Note: You must create your own CSECT for your user control blocks. You should 
not use $SRCLO or $SRCHI for control blocks generated using ICNOBPU2. 


Syntax 
XVT Location Parameters 
X'C8' in_control_str 
in_argx 
Parameters 
in_control_string 
Function Contains a string of string-standard-representation control codes that 
control the construction of the assembly record from the values in 
the parameter list in_argx. 
Format Character string in string standard representation. The maximum 
string length is 256 characters. 
Remarks For information about control codes, see “NDF String Handling’ in 
NCP and SSP Customization Guide. 
in_argx 
Function Contains the parameter list of elements that are used to construct 
the assembly record. 
Format  Variable-length parameter list. 
Example 


CALL ICNOBPU2('USER% /T5 /S','CSECT%') 


This call produces the following assembly record: 
USER CSECT 
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ICNRPFMT—Format and Print a Character String 


The ICNRPFMT utility formats a character string using the values in the argument 
list in_argx and the control codes in in_control_str. It puts this string in the NDF 
listing. If the string is too long to fit on one line in the listing, ICNRPFMT breaks it 
at a blank, if possible, and indents the continuation lines. 


Syntax 
XVT Location Parameters 
XC! in_control_str 
in_argx 
Parameters 
in_control_str 
Function Contains control codes that control the construction of the output 
line from the elements in the parameter list in_argx. 
Format Character string in string standard representation. 
Remarks For information about control codes, see “NDF String Handling” in 
NCP and SSP Customization Guide. 
in_argx 
Function Contains the parameter list of elements that are used to construct 
the listing string. 
Format  Variable-length parameter list. 
Example 


CALL ICNRPFMT('/S/5T/S/72T/F%','*%','This is a comment line%',0001) 


The control string uses the elements of in_argx to make the following output line: 


* This is a comment line l 
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ICNRPINF—Format and Print a Default or Inheritance Message 


The ICNRPINF utility inserts tab characters in a default or inheritance message. 


Syntax 
XVT Location Parameters 
X'20' in_string 
in_msg 
in_argx 
Parameters 
tn_string 


Function Contains the character code indicating the type of default string. 


Format Character string in string standard representation. The maximum 
length is 4 characters. 


Remarks The character code for the default types is as follows: 


Keyword inherited from CLUSTER 
Keyword value is a default 
Keyword inherited from GROUP 
Keyword inherited from LINE 
Keyword inherited from PU 
Keyword inherited from TERMINAL 


AVE OMOUO 


in_msg 


Function Contains the control string for the default message. 


Format Character string in string standard representation. The maximum 
length is 256 characters. 


Remarks The final string must be in the form name=value where name is the 
name of a keyword and value is the default value. Either name or 
value can be constructed by using control characters and the values 
in in_argx. 


For information about control codes, see “NDF String Handling” in 
NCP and SSP Customization Guide. 


tn_argx 


Function Contains the elements to be used in constructing the default 
message. 


Format Variable-length parameter list. 
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Example 
CALL ICNRPINF('D%', '/S=/F%', 'NTO.CWALL%', 8) 


This call produces the following default message: 
D NTO.CWALL=8 
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ICNRPPBT—Print a Trace Message for a Boolean Flag 


The ICNRPPBT utility prints a trace message in the NDF listing. The message 
consists of an identifying message string followed by the character representation 
of a Boolean flag being traced. 


Syntax 
XVT Location Parameters 
X'24' in_msg 
in_boolean 
Parameters 
in_msg 
Function Contains the message identifying the value being traced. 
Format Character string in string standard representation. The maximum 
length is 32 characters. 
tn_boolean 
Function Contains the Boolean flag that is being traced. 
Format One-byte flag. 
Example 


FLAGI='1'B 
CALL ICNRPPBT('FLAG1%', FLAG1) 


This call produces the following listing message: 
FLAG1='1'B 
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ICNRPPCH—Print a Trace Message for a Standard String 


The ICNRPPCH utility prints a trace message in the NDF listing. The message 
consists of an identifying message string followed by the the string being traced. 
The traced string is printed on as many lines as necessary. 


Syntax 
XVT Parameters 
X'28'! in_msg 
in_str 
Parameters 
in_msg 
Function Specifies the string identifying the value being printed. 
Format Character string in string standard representation. The maximum 
length is 32 characters. 
in_str 
Function Specifies the string being traced. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
Example 


IN STR='VALUE OF STRING' 
CALL ICNRPPCH('STRING1%', INSTR) 


This call produces the following listing message: 
STRINGI=VALUE OF STRING 
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ICNRPPCX—Print a Trace Message for a Nonstandard String 


The ICNRPPCH utility prints a trace message in the NDF listing. The message 
consists of an identifying message string followed by the the string being traced. 
The traced string is printed on as many lines as necessary. 


Syntax 
XVT Location Parameters 
X'2C' in_msg 
in_str 
in_length 
Parameters 
in_msg 
Function Contains the string identifying the value being printed. 
Format Character string in string standard representation. The maximum 
length is 32 characters. 
in_str 
Function Specifies the nonstandard string being traced. 
Format Character string not in string standard representation. The 
maximum length is 256 characters. 
in_length 
Function Specifies the length of the string. 
Format = Fullword integer. 
Example 


CALL ICNRPPCX('STRING1%', ‘VALUE OF STRING', 15) 


This call produces the following listing message: 
STRINGI=VALUE OF STRING 
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ICNRPPFX—Print a Trace Message for a Decimal Number 


The ICNRPPFX utility prints a trace message in the NDF listing. The message 
consists of a descriptive string followed by the character representation of the 
decimal number. 


Syntax 
XVT Location Parameters 
X'30' in_msg 
in_num 
Parameters 
in_msg 
Function Specifies the string identifying the value being printed. 
Format Character string in string standard representation. The maximum 
length is 32 characters. 
in_num 
Function Specifies the integer being traced. 
Format = Fullword integer. 
Example 


NUMBER1=256 
CALL ICNRPPFX('NUMBER1%' , NUMBER1) 


This call produces the following message: 
NUMBER1=256 
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ICNRPPHX—Print a Trace Message for a Hexadecimal Number 


The INCRPPHX utility prints in the NDF listing a message string followed by the 
string representation of a 32-bit hexadecimal number. 


Syntax 
XVT Location Parameters 
X'34!' in_msg 
in_num 
Parameters 
in_msg 
Function Specifies the string identifying the value being printed. 
Format Character string in string standard representation. The maximum 
length is 32 characters. 
tn_num 
Function Specifies the hexadecimal number being traced. 
Format = Fullword integer. 
Example 


IN_NUM=X'OOFE' 
CALL ICNRPPHX('HEXNUM%', IN_ NUM) 


This call produces the following message: 
HEXNUM= ' OOFEQ000 'X 
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ICNRPPNM—Print a Trace Message for the Value of a Number 


The ICNRPPNM utility converts a fullword integer to a specified base and then gen- 
erates its string representation. The string is padded on the left as specified, and 
then printed with an identifying string. You must specify the total length of the 
output string and the pad character. You must also specify whether the number is 
signed. If the field length specified is smaller than the string length, the string is not 
padded. The string is not truncated if it is longer than the field length. 


Syntax 


XVT Location Parameters 


X'38! in_msg 
in_num 
in_len 
in_sign 
in_pad 
in_base 
in_field 


Parameters 


in_msg 


Function Specifies the string identifying the number being traced. 


Format Character string in string standard representation. The maximum 
length is 32 characters. 


in_num 


Function Contains the number being traced. 
Format = Fullword integer. 


Remarks The number of bits in this number must be declared using in_len. 


tn_len 


Function Specifies the number of bits in in_num. 
Format = Fullword integer. 


Remarks If in_num is a signed number, then in_len is the number of bits in 
in_num plus 1. 
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ICNRPPNM 


in_sign 
Function Specifies whether the number is signed. 
Format One-byte flag. Bit 0 is checked. 
Remarks When bit 0 is set to 1, it indicates a signed number. 
in_pad 
Function Specifies the padding character. 
Format Single character; not in string standard representation. 
in base 
Function Specifies the base in which the number is to be represented. 
Format — Fullword integer. 
Remarks in base must be in the range 2 to 32. 
in_field 
Function Specifies the length of the output string. 
Format —_Fullword integer. 
Remarks lf in_field is smaller than the length of the output string, the string 


is not padded. ICNRPPNM does not truncate the output string if 
in_field is too small. 


CALL ICNRPPNM('NUMBER1%',-54,32,'1'B,' ',10,4) 


This call produces the following message: 


NUMBERI= -54 
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ICNRPTRC—Print a Trace Message for the Procedure Entry or Exit 


The ICNRPTRC utility prints a message in the NDF listing saying that the specified 
procedure is being entered or exited. 


Syntax 


XVT Location Parameters 


X'3C' in_procedure_name 
in_entry_or_exit 


Parameters 
in_procedure_name 


Function Specifies the name of the procedure being traced. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


in_entry_or_extt 


Function Specifies whether this call is a procedure entry or exit. 
Format One-byte flag. Bit 0 is checked. 


Remarks When bit 0 is set to 0, it indicates procedure entry; when bit 0 is set 
to 1, it indicates procedure exit. 


Example 
CALL ICNRPTRC('USROUTIN%', '1'B) 


This call produces the following message: 
++EXITING USROUTIN 
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ICNSMAFT—Return the Substring Following a Target String 


The ICNSMAFT utility returns a substring of the input string following the first occur- 
rence of the search string. The output string is set to null if the search string is not 
found or if the search string is '%'. 


Syntax 
XVT Location Parameters 
X'40! instr 
in_search_str 
out_str 
Parameters 
tn str 
Function Specifies the input string from which the substring is taken. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
in_search_ str 
Function Specifies the search string. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
Remarks lf in_search_str is '%', out_str is set to null. 
out_str 
Function Returns the rest of in_str following the search string. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
Remarks If the search string is not found or if the search string is '%', 
out_str is set to null. 
Example 


CALL ICNSMAFT('ABCDEF%', 'DE%' ,OUT_STR) 


This call sets out_str to F%. 
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ICNSMALN—Determine the Actual Length of a String 


The ICNSMALN utility returns the actual length of the input string. The actual 
length is the number of characters needed to express the string in string standard 
representation. The actual length includes any control or escape characters. 


Syntax 
XVT Location Parameters 
X' 44! in_str 
out_len 
Parameters 
in_str 
Function Specifies the string to be sized. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
out_len 
Function Returns the actual length of the string. 
Format = Fullword integer. 
Remarks The value of out_len cannot be 0 since the minimum string in string 
standard representation is an end delimiter (%). 
Example 


CALL ICNSMALN('AB/QC%',OUT_LEN) 


This call sets out_len to 6. 
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ICNSMBEF—Return the Substring Preceding a Target String 


The ICNSMBEF utility returns that portion of the input string before the target string. 
If the target string is not found or the target string is '%', the output string is set to 
the input string. 


Syntax 
XVT Location Parameters 
X'48' in_str 
in_target_str 
out_str 
Parameters 
in_str 
Function Specifies the input string from which the substring is taken. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
in_target_str 
Function Specifies the target string. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
out_str 
Function Returns the portion of the input string located before the target 
string. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
Remarks If the target string is not found or if the target string is '%', out_str 
is set to in_str. 
Example 


CALL ICNSMBEF('ABCDEF%', 'DE%' ,OUT_STR) 


This call sets out_str to 'ABC%'. 
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ICNSMCAT—Concatenate Strings 


The ICNSMCAT utility concatenates the strings in the input string parameter list 
and puts the resulting string in the output string. 


Syntax 
XVT Location 
X'4C' 
Parameters 
out_str 
Function 
Format 
in_str_list 
Function 
Format 
Remarks 
Example 


Parameters 


out_str 
in_str_list 


Returns the concatenated string. 


Character string in string standard representation. The maximum 
length is 256 characters. 


Variable-length strings to be concatenated. 


Variable-length parameter list of character strings in string standard 
representation. 


If only one input string is specified, that string is copied to the output 
string. 


CALL ICNSMCAT(OUT_STR, 'AB%','CD%', 'EF%') 


This call sets out_str to 'ABCDEF%'. 


486 NCP, SSP Customization Reference 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” ICNSMCMP 
Licensed Materials — Property of IBM 


ICNSMCMP—Compare Strings 


Syntax 


Parameters 


Example 


The ICNSMCMP utility searches a list of input strings for the first match to the 
target string. If it finds a match, it returns the position in the list of that string. If it 
does not find a match, out_match_num is set to 0. 


XVT Location Parameters 

X'50! out_match_num 
in_torget_ str 
in str_list 


out_match_num 


Function Returns the position in the list of the first matching string. 
Format = Fullword integer. 


Remarks If no match is found, O is returned. 


in_target_str 


Function Specifies the target string. 


Format Character string in string standard representation. The maximum 
length is 256 characters. 


in_str_list 


Function Specifies a list of strings against which the target string is compared. 


Format Variable-length parameter list of character strings in string standard 
representation. 


CALL ICNSMCMP(OUT MATCH NUM, 'ABC%', 'DEF%', 'A%', 'ABC%') 


This call sets out_match_num to 3. 
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ICNSMFMT—Format a Value into a Character String 


The ICNSMFMT utility formats a character string from a fixed point number, char- 
acter string, or Boolean value. A control string uses control codes in string 
standard representation to generate the output string. For information about control 
codes, see “NDF String Handling” in NCP and SSP Customization Guide. 


Syntax 


XVT Location Parameters 
X'54! out_str 


in control str 


we ad 
— 


tn_arg_list 


Parameters 


out_str 


Function Returns the formatted string. 


Format Character string in string standard representation. The maximum 
length is 256 characters. 


tn_control_str 


Function Controls the generation of the output string. 


Format Character string in string standard representation. The maximum 
length is 256 characters. 


Remarks This string can be a string, control codes, or a combination of the 
two. 


in_arg_list 


Function Specifies the list of elements used to construct the output string. 


Format  Variable-length parameter list. 


Example 
CALL ICNSMFMT (QUT _STR,'/S/T5/F/T5/S%' , 
'LINE NUMBER %',6,'MUST BE FIXED%') 


This call sets out_str to LINE NUMBER 6 MUST BE FIXED%. 
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ICNSMFND—Find a String 


The ICNSMFND utility finds the first occurrence of the target string in the input 
string. 


Syntax 


XVT Location Parameters 


X'58' in_str 
in_target_str 
out_pos 


Parameters 
in_str 


Function Specifies the string to be searched. 


Format Character string in string standard representation. The maximum 
length is 256 characters. 


in_target_str 


Function Specifies the string that is searched for in in_str. 


Format Character string in string standard representation. The maximum 
length is 256 characters. 


Remarks If in_target_str is '%', out_pos is set to 0. 


out_pos 


Function Returns the position of the first occurrence of the target string in the 
input string. 


Format —Fullword integer. 


Remarks If the target string is not found or is '%', out_pos is set to 0. 


Example 
CALL ICNSMFND('ABCDEF%', 'C%',OUT_POS) 


This call sets out_pos to 3. 
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ICNSMLEN—Determine the Logical Length of a String 


The ICNSMLEN utility returns the logical length of the string. The logical length is 
the length of the string after the effects of string standard control codes and special 
characters have been processed. 


Syntax 
XVT Location Parameters 
X'5C' in_str 
out_len 
Parameters 
tn_str 
Function Specifies the string to be processed. 
Format Character string in string standard format. The maximum length is 
256 characters. 
out_len 
Function Returns the logical length of the input string. 
Format = Fullword integer. 
Example 


CALL ICNSMLEN('ABCD7~7EF%' , OUT_LEN) 


This call sets out_len to 7. The normal string version of in_str is 'ABCD-EF'. The 
escape character - and the end-of-string character % are not counted. 
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ICNSMPLS—Convert a Standard String to a Nonstandard String 


The ICNSMPLS utility converts a string in string standard representation to its 
equivalent normal string. It also returns the length of the resulting normal string. 


Syntax 


XVT Location Parameters 


X'60' in_str 
out_norm_str 
out_len 


Parameters 


in_str 


Function Specifies the string to be converted to non-string standard represen- 
tation. 


Format Character string in string standard representation. The maximum 
length is 256 characters. 


out_norm_str 


Function Returns a normal string. 


Format Character string in non-string standard representation. The 
maximum length is 256 characters. 


Remarks This string has a maximum length of 256 characters. 


out_len 


Function Returns the number of characters in the resulting normal string. 


Format = Fullword integer. 


Example 
CALL ICNSMPLS('ABC-%DEF%',OUT_NORM STR,OUT LEN) 


This call sets out_norm_str to 'ABC%DEF' and out_len to 7. 
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ICNSMSTD—Convert a Nonstandard String to String Standard 
Representation 


The ICNSMSTD utility converts a string in non-string standard representation to a 
string in string standard representation. The routine inserts an escape character 

before each special character in the string and adds an end-of-string character at 
the end of the string. 


Syntax 
XVT Location Parameters 
X'64' in_norm_str 
in_len 
out_str 
Parameters 
in_norm_str 
Function Specifies the string to be converted to string standard represen- 
tation. 
Format Character string in non-string standard representation. The 
maximum length is 256 characters. 
in_len 
Function Specifies the number of characters in the input string that are to be 
converted. Normally this is the length of the input string. 
Format = Fullword integer. 
out_str 
Function Returns the string standard equivalent of the input string. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
Remarks ICNSMSTD returns only the first in_len characters of the input 
string. 
Example 


CALL ICNSMSTD('ABC%DEF',7,0UT_STR) 


This call sets out_str to 'ABC-%DEF%'. 
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ICNSMSUB 


ICNSMSUB—Return a Substring of a String 


The ICNSMSUB utility returns a substring of the input string starting at 
in_start_pos, with a length of in_len. Note that an escape character (-) paired 
with the character immediately following is considered one logical character when 
calculating the length of the substring. 


Syntax 
XVT Location 
X'68' 
Parameters 
tn_str 
Function 


Format 


in_start_pos 


Function 
Format 


Remarks 


in_len 


Function 


Format 


out_str 


Function 


Format 


Parameters 


in_str 
in_start_pos 
in_len 
out_str 


Specifies the string from which the substring is to be taken. 


Character string in string standard representation. The maximum 
length is 256 characters. 


Specifies the position in the input string where the substring begins. 
Fullword integer. 


The first character of a string is character 1, not character 0. 


Specifies the length of the substring. 


Fullword integer. 


Returns the substring. 


Character string in string standard representation. The maximum 
length is 256 characters. 
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Example 
CALL ICNSMSUB('ABC-%DEF',3,4,0UT_STR) 


This call sets out_str to 'C-%DE'. Note that the escape character with the percent 
sign ('-%') counts as 1 character. 
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ICNSMTRM—Trim Trailing Blanks from a String 


The ICNSMTRM utility removes any trailing blanks from the input string and returns 
the result in the output string. 


Syntax 
XVT Location Parameters 
X'6C! instr 
out str 
Parameters 
in_str 
Function Specifies the string from which trailing blanks are to be stripped. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
out_str 
Function Returns the resulting string. 
Format Character string in string standard representation. The maximum 
length is 256 characters. 
Example 


CALL ICNSMTRM('ABCDEF %',OUT_STR) 


This call sets out_str to 'ABCDEF%'. 
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ICNTCBTA—Convert a Bit to an Arithmetic Number 
The ICNTCBTA utility converts a bit to a fullword integer. 


Syntax 
XVT Location Parameters 
X'70! in bit 
out_value 
Parameters 
in_bit 
Function Specifies the bit to be converted to an integer. 
Format = Single binary digit. 
out_value 
Function Specifies the integer representation of the bit. 
Format = Fullword integer. 
Example 


CALL ICNTCBTA(B'1' ,OUT_VALUE) 


This call sets out_value to the fullword integer 1. 
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ICNTCBTC—Convert a Bit to a Decimal String 


The ICNTCBTC utility converts a bit to a character string of its decimal value. 


Syntax 
XVT Location Parameters 
X'74! in bit 
out_string 
Parameters 
in bit 
Function Specifies the bit to be converted to a decimal string. 
Format Single binary digit. 
out_string 
Function Specifies the string representation of the decimal value of the bit. 
Format Character string with a length of 16 characters. 
Example 


CALL ICNTCBTC(B'1',OUT_STRING) 


This call sets out_string to the string '1%'. 
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ICNTCDEC—Convert a Decimal String to a Number 


The ICNTCDEC utility determines the numeric value represented by the decimal 
digits of the input string. If the input string contains characters other than the digits 
0 to 9, or if the resulting value is outside the range -—(231-1) to (231-1) inclusive, the 
error flag is set to 1. 


Syntax 


XVT Location 
X'78! 


Parameters 


in_decstring 


Function 


Format 


Remarks 


out_value 


Function 


Format 


out_error 


Function 


Format 


Remarks 


Example 


Parameters 


in_decstring 
out_value 
out_error 


Specifies the string to be converted to a numeric value. 


Character string in string standard representation. The maximum 
length is 16 characters. 


The string can contain only the characters 0 to 9. 


Returns the numeric value of the decimal string. 


Fullword integer. 


Specifies whether the input string was a valid decimal number, or if 
the value was in the proper range. 


One-byte flag. Bit 0 is checked. 


If bit O is set to 1, the conversion was not valid. 


CALL ICNTCDEC('256%',OUT_VALUE,OUT_ERROR) 


This call sets out_value to 256 and out_error to '0'B. 
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ICNTCDTC—Convert a Number to a Decimal String 


The ICNTCDTC utility converts a numeric value to a string representing the decimal 
value of the number. The routine generates a minus sign for negative numbers. 


Syntax 
XVT Location Parameters 
X'7C! in_number 
out_decstring 
Parameters 
in_number 
Function Specifies the number to be converted to a decimal string. 
Format = Fullword integer. 
Remarks The number must be an integer value in the range —(231-1) to 
(231-1) inclusive. 
out_decstring 
Function Returns the character representation of the decimal value of the 
input number. 
Format Character string in string standard representation. The maximum 
length is 16 characters. 
Remarks The string can contain only the characters 0 to 9 and the minus sign 
( it ). 
Example 


CALL ICNTCDTC(-256,0UT_DECSTRING) 


This call sets out_decstring to '-256%'. 
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ICNTCDTH—Convert a Number to a Hexadecimal String 


The ICNTCDTH utility converts the input number to a string representation of its 
hexadecimal value. 


Syntax 
XVT Location Parameters 
X'80' in_number 
out_hexstring 
Parameters 
in_number 
Function Specifies the number to be converted into a hexadecimal string. 
Format = Fullword integer. 
Remarks The number must be an integer in the range -(231-1) to (231-1) 
inclusive. 
out_hexstring 
Function Returns the character representation of the hexadecimal value of 
the input string. 
Format Character string in string standard representation. The maximum 
length is 16 characters. 
Remarks The output string can contain only the characters A to F and 0 to 9. 
Example 


CALL ICNCDTH(256, OUT_HEXSTRING) 


This call sets out_hexstring to '100%'. 
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ICNTCHEX 


ICNTCHEX—Convert a Hexadecimal String to a Number 


The ICNTCHEX utility converts the input hexadecimal string to its numeric value. If 
the input string does not represent a valid hexadecimal number, or if the resulting 
value is outside the range —(231-1) to (231-1) inclusive, the error flag is set to 1. 


Syntax 


XVT Location 


X' 84! 


Parameters 


in_hexstring 
out_value 


out_error 


Parameters 


in_hexstring 


Function 


Format 


Remarks 


out_value 


Function 


Format 


out_error 


Function 
Format 


Remarks 


Example 


Specifies the hexadecimal string to be converted to a number. 


Character string in string standard representation. The maximum 
length is 16 characters. 


The string may contain only the characters A to F and 0 to 9 and 
may have no more than 8 hexadecimal digits. 


Returns the numeric value of the input hexadecimal string. 


Fullword integer. 


Specifies whether the conversion was valid. 
One-byte flag. Byte 0 is checked. 


If the hexadecimal string does not represent a valid hexadecimal 
number, or if the resulting value is outside the range —(231-1) to 
(231.-1) inclusive, the error flag is set to 1. 


CALL ICNTCHEX('1C 4F%',OQUT_VALUE,OUT ERROR) 


This call sets out_value to 7247 and out_error to '0'B. 
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ICNUSDTG—Get the Date and Time of Generation 


The ICNUSDTG utility returns the date and time of generation contained in the 
DTG NCP control block created by NDF. 


Syntax 


XVT Location Parameters 


X'A8' out_date 
out_time 


Parameters 
out_date 


Function Contains the generation date. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks The date is returned in the format yy/mm/dd. 


out_tume 


Function Contains the time of generation. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks The time is returned in the format hh:mm:ss. 


Example 
If the load module was generated on June 12, 1993, at 2:30 p.m., then the call: 
CALL ICNUSDTG(out_date, out_time) 


sets out_date to 93/06/12 and out_time to 14:30: 38. 
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ICNUSGKI—Get Keyword Values 


The ICNUSGKI utility returns all Keyword values associated with a given keyword 
on the current statement. You can use this routine only for post-processing rou- 
tines. 


Values returned adhere to the following rules: 


e All values are in string standard representation. They can be up to 256 charac- 
ters long. 


e Only keyword values coded at their lowest statement level are returned. For 
example, keywords that can be coded on the GROUP, LINE, and TERMINAL 
statements will be returned only if TERMINAL is the current statement, unless 
this keyword is required at a higher level. 


If a keyword is required at a higher level in certain configurations, and is coded 
at a lower level for the current configuration, it is returned as a null value and 
no errors are generated. 


e Default values and values inherited from other statements will be returned as if 
they were coded on the current statement. 


e Keywords that have no coded value and no default for the current statement 
will be returned as a null value. 


e Keywords that have no coded value and are not immediately defaulted by NDF 
will be defaulted and returned during GENEND processing. If ICNUSGKI is 
coded for a keyword that will be defaulted during GENEND processing, 
ICNUSGKI gets a return code of 5. 


e Keywords that are not valid for the current statement or that are not coded at 
their lowest statement level will be returned as a null value and ICNUSGKI 
returns an error code. | 


e If the keyword is no longer supported for the current statement, ICNUSGK! 
returns an error code. 


Syntax 
XVT Location Parameters 
X"AC' in_keyword 
out_ptrs 
out_count 
out_status 
Parameters 
tn_keyword 


Function Specifies the name of the keyword for which your routine requires 
values. 


Format  Sixteen-character string in string standard representation. 
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out_ptrs 


Function 


Format 


out_count 


Function 


Format 


out_status 


Function 
Format 


Remarks 
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Contains the pointers to the keyword values. 


An array of up to 100 fullword pointers, each pointing to an area of 
up to 256 bytes to receive the keyword value itself in string standard 
value. The number of pointers supplied must be equal to the largest 
number of subvalues that may be returned or the number supplied 
on the previous call to ICNUSGKI, whichever is larger. ICNUSGKI 
will initialize the value areas to null based on the number of values 
returned on the previous invocation. 
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256 characters. 


Contains the number of subvalues pointed to by out_ptrs. 


Fullword integer. 


Returns the status code from ICNUSGKI. 
Fullword integer. 


Out_status is 0 if the subvalues are returned successfully. Nonzero 
codes are shown below: 


Status 
Code Meaning 
0 All keyword values are returned successfully. 
1 The current statement is not an NCP statement. An error 


message has been issued. 


2 The current keyword is not a valid NCP keyword. An error 
message has been issued. 


The current keyword is not at its lowest level. 


ICNUSGKI is invoked during pre-NCP statement keyword proc- 
essing. An error message has been issued. 


5 The current keyword is not coded on the current statement. 
The keyword value will be defaulted during GENEND proc- 
essing. 
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Example 
CALL ICNUSGKI('VERSION%' ,OUT_PTRS,QUT_COUNT,OUT STATUS) 


If BUILD is the current statement and VERSION=V4R3 is coded on the BUILD defi- 
nition statement, the first element of out_ptrs would point to the string 'V4R3' and 
all other elements would contain zeros. OQut_count would be set to 1 and out_code 
would be set to 0. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 4. NDF Utility Directory 505 


ICNUSKAD “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


ICNUSKAD—Add a Keyword to the Generation Definition 


The ICNUSKAD utility adds a keyword and its subvalues to the current generation 
definition statement. If you code the keyword in the generation definition, the sub- 
values are appended to the existing subvalues. For each subvalue added, NDF 
prints the message ADDED keyword(x)=subvalue. For each subvalue appended, 
NDF prints the message APPENDED keyword(x)=subvalue. Keyword is the keyword 
name, x is the subvalue number, and subvalue is the subvalue. If the keyword 
was not coded, the new keyword and subvalues are added. 


Syntax 


XVT Location Parameters 


X'88' in_uwga_name 
in_key_name 
in_subv_num 
in_subv_list 
out_code 


Parameters 
in_uwga_name 


Function Specifies the name of the user-written-generation-application load 
module specified on the USERGEN keyword of the OPTIONS defi- 
nition statement. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks NDF uses this value for diagnostic purposes. 


in_key_name 


Function Specifies the name of the keyword to be added to the generation 
definition. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


tn_subv_num 


Function Specifies the number of subvalues to be added to the generation 
definition. 


Format = Fullword integer. 


Remarks You can have a maximum of 100 subvalues. 
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Examples 


in_subv_list 


Function Specifies the subvalues to be added to the generation definition. 
Format Array of 256-byte character strings in string standard representation. 


Remarks You can have a maximum of 100 subvalues. 


out_code 


Function Returns the result of the operation. 
Format = Fullword integer. 


Remarks Possible return codes are as follows: 


Return 
Code Meaning 
0 Keyword and subvalues were added successfully. 
4 Keyword value length exceeds 255 characters. An error 


message has been issued, and one or more subvalues have 
been ignored. 


5 NDF storage error. An error message has been issued. This 
return code is not issued again for the current statement. 


10 Maximum number of subvalues has been exceeded. An error 
message has been issued and one or more subvalues have 
been ignored. 


11 Unusable input passed from the user application. An error 
message has been issued. The keyword and its subvalues 
have been ignored. 


IN SUBV_LIST='1%'! 
IN SUBV_LIST='2%' 


CALL ICNUSKAD('USER1%', 'REDIAL%',2, IN SUBV_LIST,OUT CODE) 


lf REDIAL was not coded on the current definition statement, this call adds the 
keyword REDIAL with the subvalues 1 and 2 to the current definition statement. 
The out_code parameter is set to 0. This gives the same results as if 
REDIAL=(1,2) had been coded on the current definition statement. 


In the following example, INIT has been coded on the current definition statement 
as INIT=USER2: 


IN SUBV_LIST='USER1%' 
CALL ICNUSKAD('USER1%', 'INIT%',1,IN_SUBV_LIST, OUT_CODE) 


This call sets out_code to 0 and produces the same result as if INIT=(USER2,USER1) 
had been coded on the current definition statement. 
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ICNUSKRP—Replace Keyword Values in the Generation Definition 


The ICNUSKRP utility replaces a keyword's subvalues with new subvalues passed 
from a user generation application. If the keyword was not coded on the current 
definition statement, the new keyword and its subvalues are added to the gener- 
ation definition. If the keyword was coded, the keyword's current subvalues are 
deleted and the new subvalues are added. For each keyword that is deleted, NDF 
prints the message DELETED keyword. For each subvalue added, NDF prints the 
message ADDED keyword(x)=subvalue where keyword is the keyword name, x is the 
subvalue number, and subvalue is the subvalue. 


XVT Location 
X'8C' 


Parameters 
in_uwga_name 


Function 


Format 


Remarks 


in_key_name 
Function 


Format 


in_Subv_num 


Function 


Format 


Remarks 
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Parameters 


in_uwga_name 
in_key_name 
in_subv_num 
in_subv_list 
out_code 


Specifies the name of the user-generation-application load module 
specified on the USERGEN keyword of the OPTIONS definition 
statement. 


Character string in string standard representation. The maximum 
length is 16 characters. 


NDF uses this value for diagnostic purposes. 


Specifies the name of the keyword to be replaced in the generation 
definition. 


Character string in string standard representation. The maximum 
length is 16 characters. 


Specifies the number of subvalues to be replaced in the generation 
definition. 


Fullword integer. 


You can have a maximum of 100 subvalues. If in_subv_num is 0, 
NDF deletes the keyword from the definition statement. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” ICNUSKRP 
Licensed Materials — Property of IBM 


in_subv_list 


Function Specifies the subvalues to be replaced in the generation definition. 
Format Array of 256-byte character strings in string standard representation. 


Remarks You can have a maximum of 100 subvalues. 


out_code 


Function Returns the result of the operation. 
Format = Fullword integer. 


Remarks Possible return codes are as follows: 


Return 
Code Meaning 
0 Keyword and subvalues were replaced successfully. 
4 Keyword value length exceeds 255 characters. An error 


message has been issued and one or more subvalues have 
been ignored. 


5 NDF storage error. An error message has been issued. This 
return code is not issued again for the current statement. 


10 The maximum number of subvalues has been exceeded. An 
error message has been issued and one or more subvalues 
have been ignored. 


11 Unusable input passed from the user application. An error 
message has been issued. The keyword and its subvalues 
have been ignored. 


12 ICNUSKRP attempted to delete a duplicate keyword. An error 
message has been issued. An error was found in the gener- 
ation definition. The keyword and its subvalues have not been 
replaced. 


Example 
CALL ICNUSKRP('USER1%', 'LEVEL2%', 1, 'USELVL2%' ,OUT_CODE) 


This call passes the keyword LEVEL2 to NDF with the subvalue USELVL2. It is 
the same result as if LEVEL2=USELVL2 had been coded on the current definition 
statement. 
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ICNUSLIB—Search the SYSLIB Data Set for a Member 


The ICNUSLIB utility searches the SYSLIB data set specified in the JCL and veri- 
fies the presence of a specific member. It returns a code indicating whether the 
member was found. 


Syntax 


XVT Location 
X'BC' 


Parameters 
Status 


Function 


Format 


mem_name 


Function 


Format 


out_code 


Function 
Format 


Remarks 


Example 


Parameters 


status 
mem_name 
out_code 


Specifies the NDF status word. 


Fullword. 


Specifies the name of the member to be checked for. 


Character string in string standard representation. The maximum 
length is as follows: 


MVS 8 characters 
VSE 7 characters 
VM 16 characters 


Returns the status of the operation. 
Fullword integer. 


Zero indicates that the member was found. Four (for MVS and VM) 
or 8 (for VSE) indicates that the member was not found. Error 
ICN623l is issued if an input/output error occurs. 


CALL ICNUSLIB(STATUS, 'MEMBERO1%' ,OUT_CODE) 


If MEMBERO1 is found in the SYSLIB data set, out_code is set to 0. If it is not found, 
out_code is set to 4 or 8. 
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ICNUSNEW 


ICNUSNEW—Get the NEWNAME Value for the Generation Definition 


The ICNUSNEW utility returns the NEWNAME value for the current generation defi- 
nition. The NEWNAME value is specified either on the BUILD definition statement 
in the generation definition or in the default generated by NDF. An error results if 
this routine is called before the BUILD definition statement has been processed by 


NDF. 


Syntax 


XVT Location 


X'90! 


Parameters 
in_uwga_name 


Function 


Format 


Remarks 


out_newname 


Function 


Format 


Example 


Parameters 


in_uwga_name 
out_newname 


Specifies the name of the user-generation-application load module 
specified on the USERGEN keyword of the OPTIONS definition 
statement. 


Character string in string standard representation. The maximum 
length is 16 characters. 


NDF uses this value for diagnostic purposes. 


Returns the NEWNAME value. 


Character string in string standard representation. The maximum 
length is 16 characters. 


If the following BUILD definition statement has been coded: 
BUILD NEWNAME=NCPGEN 


this call: 


CALL ICNUSNEW('USER1%' ,OUT_NEWNAME) 


sets out_newname to 'NCPGEN%'. 
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ICNUSRNA—Get Network Addresses for a User-Defined Resource 


Syntax 


Parameters 


The ICNUSRNA utility gets the network addresses associated with a user-defined 
resource in the generation definition. You can use this routine for post-processing 
only. 


For all resources except those defined for dynamic reconfiguration, NDF determines 
the network address after it processes the definition statement on which the 
resource is defined. The addresses of dynamic reconfiguration resources defined 
by the BUILD, LUPOOL, LUDRPOOL, and PUDRPOOL definition statements are 
determined during processing of the NETWORK definition statement. If NETWORK 


is not coded, the addresses are determined when the GENEND definition statement 
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is processed. 


You cannot call this routine with an undefined statement symbol, with a statement 
symbol that is defined but has no associated network address, or before the 
network address for a resource has been determined. 


XVT Location Parameters 
X'BQ' in_symbol 
out_sa 
out_na 
out_na_count 
out_status 
in_symbol 


Function Specifies the statement symbol associated with the network 
addresses. requested. 


Format  Sixteen-character string in string standard representation. 


out_sa 


Function Returns the subarea associated with the statement symbol. 


Format —_- Fullword integer. 


out_na 


Function Returns the first network address associated with the statement 
symbol. 


Format = Fullword integer. 
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out_na_count 


Function 


Format 


out_status 


Function 
Format 


Remarks 


Example 


ICNUSRNA 


Returns the number of consecutive network addresses associated 
with the statement symbol. 


Fullword integer. 


Returns the status code from ICNUSRNA. 
Fullword integer. 


Out_status is O if a network address is returned. Nonzero codes 
are as follows: 


Status 
Code Meaning 
0 Network address returned successfully. 
1 Statement symbol is undefined. An error message has been 
issued. 
2 No network address is associated with the statement symbol. 


An error message has been issued. 


3 Network address associated with the statement symbol has not 
yet been determined. An error message has been issued. 


If the resource with the name SYMBOL1 has a subarea of 1 and the network 
addresses 25 and 26, then the call: 


CALL ICNUSRNA('SYMBOL1%',OUT_SA,QUT_NA,OUT_NA COUNT, OUT STATUS) 


sets out_sato1, out_na to 25, out_na_count to 2, and out_status to O. 
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ICNUSSTA—Activate a Group of Statements 


The ICNUSSTA utility activates a statement group. A statement group consists of 
one or more statements that have been passed to NDF by ICNUSSTS with the 
same data key. NDF uses the statement group that matches the data key passed 
to ICNUSSTA as input. Statements within a statement group are processed in the 
same order they were generated. Before each statement in a statement group is 
processed, NDF prints GENERATED BY xxxxxxxx in the NDF listing, where xxxxxxxx 
is the name of the user-written generation application that created the statement. 


If ICNUSSTA is called to activate a statement group and another statement group 
is currently being processed, the statement group is queued for processing. If mul- 
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tiple statement groups are queued, they are processed in the order they were 


created. 
Syntax 
XVT Location Parameters 
X'94' in_sg datakey 
out_code 
Parameters 


in_sg_datakey 


Function Specifies the data key of the statement group to be activated. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks The first 3 characters of the data key must match the first 3 letters 
of one of the load module names specified on the USERGEN 
keyword on the OPTIONS definition statement. 


out_code 


Function Returns the status of the routine call. 
Format — Fullword integer. 


Remarks The status codes returned are as follows: 


Status 
Code Meaning 
0 The statement group has been activated or queued for acti- 
vation. 
1 The statement group does not exist. An error message has 
been issued. 
3 The statement group has already been processed. An error 


message has been issued. 
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Example 
CALL ICNUSSTA('UWGAKEY1%' ,OUT_CODE) 


This call activates the statement group with the data key 'UWGAKEY1%'. The 
out_code keyword is set to 0. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 4. NDF Utility Directory 515 


ICNUSSTC “Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


ICNUSSTC—Add a Comment to a User-Generated Statement Group 


The ICNUSSTC utility builds a comment card from the contents of a global variable 
specified on the call and adds it to a user-generated statement set. 


Syntax 
XVT Location Parameters 
X'C4! tn_datakey 
in_val 
out_code 
Parameters 
in_datakey 
Function Specifies the name of the generated statement group. This group 
will not create or begin a new group. 
Format Character string in string standard representation. The maximum 
length is 9 characters. 
in_val 
Function Specifies the name of the global variable containing the comment 
string. ICNUSSTC precedes the string with an asterisk and a 
space. 
Format Character string in string standard representation. 
Remarks The length of the comment string should not exceed 70 characters. 
out_code 
Function Specifies the return code from the call. 
Format = Fullword integer. 
Example 


CALL ICNUSSTC('STMTGRP%',KYVAL,OUT_CODE) 

This call will insert a comment into the generated statement group STMTGRP. If 
the variable KYVAL contains the comment: 

This is a certain type of line% 

then the comment would appear as: 


* This 1s a certain type of line 
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ICNUSSTI—Set an Insertion Point for a Statement Group 


The ICNUSSTI utility allows you to determine the location where the next statement 
generated by ICNUSSTS will be inserted into the statement group. Normally, 
ICNUSSTS appends statements to the end of a statement group. With ICNUSSTI, 
you can have the statement added at the top of the group or inserted before or 
after any label in the group. 


You supply the name of the statement group and the label where the insertion is to 
take place, and specify whether the insertion is to be before or after the label. The 
position indicator for before is 'B%' and for after is 'A%'. If you want the statement 
to be added at the top of the group, specify '%'. 


Note that ICNUSSTI sets the position only for the next statement generated by 
ICNUSSTS. Subsequent calls to ICNUSSTS will append statements to the end of 
the group unless ICNUSSTI is again used to set the insertion point. 


Syntax 
XVT Location Parameters 
X'B8' in_sg_datakey 
in_stmt_symbol 
in_position 
out_code 
Parameters 


tn_sg datakey 


Function Specifies the statement group to which a statement is to be added. 
Format Sixteen-character string in string standard representation. 


Remarks This value must have been set previously by your generation appli- 
cation. 


in_stmt_symbol 
Function Specifies the label of the statement symbol where the next state- 


ment is to be inserted. 


Format  Sixteen-character string in string standard representation. 
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in_position 


Function Specifies where the next statement is to inserted. 
Format  Sixteen-character string in string standard representation. 
Remarks Position indicators are as follows: 

'B%' Next statement is inserted before the label. 

'A%' Next statement is inserted after the label. 


%' Next statement is inserted at the top of the group, before any 
existing statements. 


out_code 


Function Specifies the return code. 
Format —_ Fullword integer. 


Remarks Status codes are as follows: 


Status 
Code Meaning 
0 The statement group has been activated or queued for acti- 
vation. 
1 The statement group does not exist. An error message has 
been issued. 
3 The statement group has already been processed. An error 


message has been issued. 


Examples 
Starting with this statement group: 


* Statement group 1 
LABEL1 STMNT KEY1=VALUE 
LABEL2 STMNT KEY1=VALUE 


you can insert a statement between LABEL1 and LABEL42, like so: 
CALL ICNUSSTI(STMT_GROUP1, LABEL1, 'A%' ,OUT_ CODE) 


or 
CALL ICNUSSTI(STMT_GROUP1,LABEL2, 'B%' ,OUT CODE) 


To insert a statement at the top of the statement group, you can do this: 
CALL ICNUSSTI(STMT_GROUP1,LABEL2,'%',OUT_CODE) 
Note that LABEL2 Is ignored in this case. 
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ICNUSSTS—Save a Definition Statement 


The ICNUSSTS utility allows your generation application to pass statements and 
their associated keywords to NDF for future processing. ICNUSSTS builds state- 
ments and their keywords for calling the user-written generation application. Mul- 
tiple statements can be grouped together by giving them identical data keys. NDF 
does not immediately process statement groups created by ICNUSSTS. A state- 
ment group must first be activated using ICNUSSTA before NDF treats it as input. 
If bit 1 of in flag was set when ICNUSSTS created the statement group, then 
when ICNUSSTA activates the statement group, it will be added to the NEWDEFN 
file, but will not be processed by NDF. 


A statement is composed of a statement symbol, statement name, and keywords. 
The statement symbol is optional; the statement name is required. There may be 
any number of keywords. Each keyword is composed of a keyword name and a 
keyword value. 


Every call to ICNUSSTS must have the data key as a parameter. You must specify 
the statement name on the first call to ICNUSSTS for a new statement. If there is 
to be a statement symbol, it must be a parameter on the first call. For each suc- 
cessive call to ICNUSSTS for the same statement, the statement name and state- 
ment symbol parameters must be null strings. On the first call to IONUSSTS, the 
keyword name and keyword value strings can be null only if there are no keywords 
for the statement. In any other call, you must specify the keyword name and 
keyword value strings. Bit 0 of in_flag is the last-call indicator. For the last call to 
ICNUSSTS for a statement, you must set bit 0 of in_flag to 1. For all other calls 
to ICNUSSTS, you must set bit 0 of in_flag to 0. 


Syntax | 


XVT Location 
Parameters 

X'98' tn_sg_datakey 
in_stmt_symbol 
tn_stmt_name 
in_key_name 
in_key_ value 
in_flag 
out_code 


Parameters 
un_sg_ datakey 


Function Specifies the data key of the statement group to be activated. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks The first 3 characters of the data key must match the first 3 letters 
of one of the load module names specified on the USERGEN 
keyword of the OPTIONS definition statement. 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 Chapter 4. NDF Utility Directory 519 


ICNUSSTS 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


in_stmt_symbol 


Function 


Format 


Remarks 


in_stmt_name 


Function 


Format 


Remarks 


in_key_name 


Function 


Format 


Remarks 


in_key_value 


Function 


Format 


Remarks 


in_flag 


Function 


Format 
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Specifies the statement symbol. 


Character string in string standard representation. The maximum 
length is 9 characters. 


This parameter must be '%' for every call to ICNUSSTS after the 
first call. 


Specifies the name of the statement being saved. 


Character string in string standard representation. The maximum 
length is 13 characters. 


This parameter must be coded with the statement name on the first 
call to ICNUSSTS. On successive calls, the parameter must be 
1%", 


Specifies the name of the keyword. 


Character string in string standard representation. The maximum 
length is 13 characters. 


The keyword name must be passed on every call to ICNUSSTS 
unless the statement has no keywords. If there are no keywords, 
the keyword name must be '%'. 


Specifies the value of the keyword. 


Character string in string standard representation, with a maximum 
length of 256 characters. 


The keyword value must be passed on every call to ICNUSSTS 
unless the definition statement has no keywords. If there are no 
keywords, the keyword value must be '%'. 


Specifies the flag bits used by the ICNUSSTS routine. 
One-byte flag. Bit O through bit 2 are checked. 
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Remarks lf bit 0 is set to 1, the call is the last call for a statement. If bit 1 is 
set to 1, the statement, when activated, will be passed to the 
NEWDEFN file but will not be processed by NDF. If bit 2 is set, the 
statement, when passed to the NEWDEFN file, will not be sur- 
rounded by IGNORE and NOIGNORE statements. 


out_code 


Function Returns the status of the call. 
Format = Fullword integer. 


Remarks The codes returned in out_code are as follows: 


Status 
Code Meaning 

0 Data successfully added to statement group. 

2 Storage for user application statements has been exceeded. 
An error message has been issued. Do not call this routine 
again. 

4 Maximum number of statement groups exceeded. An error 
message has been issued. Do not call this routine again. 

5 Incorrect sequence of calls to ICNUSSTS. An error message 
has been issued. The current statement being created is 
ended. 

6 Statement group is either already processed, is being proc- 


essed, or is queued for processing. The data is not added to 
the statement group. An error message has been issued. 


Examples 


CALL ICNUSSTS('UWGAKEY1%', 'LINE1%', 'LINE%', 'UACB%', 'X$1%','Q'B,OUT_CODE) 
CALL ICNUSSTS('UNGAKEY1%', '%','%', 'CALL%', 'REDIAL=(1,2)%','1'B,OUT_CODE) 


CALL ICNUSSTS('UWGAKEY1%', 'PU1%', 'PU%', '%', '%', '1'B,OUT_CODE) 


These calls create the following statement group with data key 'UNGAKEY1' in NDF: 


LINE1 LINE UACB=X$1,CALL=REDIAL 
PUI PU 
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If you want this statement group to only be passed to the NEWDEEFN file and not 
be processed by NDF, code the following: 


CALL ICNUSSTS('UWGAKEY1%', 'LINE1%', 'LINE%', 'UACB%', 'X$1%', '01'B,OUT_CODE) 
CALL ICNUSSTS('UWGAKEY1%','%','%', 'CALL%', 'REDIAL=(1,2)%','11'B,OUT_CODE) 


CALL ICNUSSTS('UWGAKEY1%', 'PU1%', 'PU%','%', '%','11'B,OUT_CODE) 
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ICNUSTAD—Add an Entry to the Table Storage Facility 


The ICNUSTAD utility creates an entry in the NDF table storage facility. You 
supply a data key with the data. If the data key is matched with an entry already in 
the table, the routine returns an error code of 1. If the data key is not in the table, 
ICNUSTAD creates the entry and stores the data with its key. 


You can use the routine ICNUSTRT to retrieve the data in an entry and the routine 
ICNUSTUP to update the data in an entry. 


Syntax 
XVT Location Parameters 
X'9C! in_data_key 
in_uwga_data 
out_code 
Parameters 
in_data_key 


Function Specifies the data key used by NDF to identify an entry in the table 
storage facility. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks The first 3 characters must match the first 3 letters of one of the 
load module names specified on the USERGEN keyword on the 
OPTIONS definition statement. 


in_uwga_data 


Function Specifies the data to be stored in the table storage facility entry. 


Format 20 bytes of data of any type. 
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out_code 


Function Returns the status of the operation. 
Format = Fullword integer. 


Remarks The status codes returned are as follows: 


Status 
Code Meaning 
0 NDF table storage facility entry successfully created. 
1 NDF table storage facility entry already exists. No error 


message is issued. 


2 Table facility error. An error message is issued and the data is 
not stored. Do not call the routine again. 


11 in_data_key is not valid. An error message is issued and the 
data is not stored. 


Example 
CALL ICNUSTAD('USERKEY%', ‘TWENTY BYTES OF DATA' ,OUT_CODE) 


This call sets out_code to 0, creates a new entry in the table storage facility with 
the data key 'USERKEY%', and stores the 20 bytes in the NDF table storage facility. 
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ICNUSTRT—Get Data from the Table Storage Facility 


The ICNUSTRT utility retrieves the data from an entry in the NDF table storage 
facility. If the data key is not matched, the routine returns an error code of 3. If the 
data key is matched with an entry already in the table, ICNUSTRT updates the data 
field of the matching table entry with the new data. 


Syntax 
XVT Location Parameters 
X' AO" in_data_key 
out_uwga_data 
out_code 
Parameters 
in_data_key 


Function Specifies the data key used by NDF to identify an entry in the table 
storage facility. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks The first 3 characters must match the first 3 letters of one of the 
load module names specified on the USERGEN keyword on the 
OPTIONS definition statement. 


out_uwga_ data 


Function Specifies the data to be retrieved from the table storage facility. 


Format 20 bytes of data of any type. 


out_code 


Function Returns the status of the operation. 


Format = Fullword integer. 
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Remarks The status codes returned are as follows: 


Status 
Code Meaning 
0 NDF table storage facility data successfully retrieved. 
2 Table facility error. An error message is issued and the data is 


not retrieved. Do not call the routine again. 


3 NDF table storage facility entry not found. No error message 
is issued and the data is not retrieved. 


11 Incorrect input. An error message is issued and the data is 
not retrieved. 


Example 


The data 'TWENTY BYTES OF DATA' has already been saved under the key 
'USERKEY' (see the example for ICNUSTAD). 


CALL ICNUSTRT('USERKEY%' ,OUT_UWGA_DATA, OUT_CODE) 


This call sets out_uwga_data to 'TWENTY BYTES OF DATA' and sets out_code to 0. 
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ICNUSTUP—Update the Table Storage Facility 


The ICNUSTUP utility updates the data field of an entry in the NDF table storage 
facility. If the data key is not matched with an entry already in the table, the routine 
returns an error code of 3. If the data key is matched, the data field of the 
matching table entry is updated with the new data. 


Syntax 
XVT Location Parameters 
X'A4! in_data_key 
in_uwga_data 
out_code 
Parameters 
in_data_key 


Function Specifies the data key used by NDF to identify an entry in the table 
storage facility. 


Format Character string in string standard representation. The maximum 
length is 16 characters. 


Remarks The first 3 characters must match the first 3 letters of the load 
module name specified on the USERGEN keyword on the OPTIONS 
definition statement. 


in_uwga_data 


Function Specifies the data to be stored in the table storage facility entry. 


Format 20 bytes of data of any type. 


out_code 


Function Returns the status of the operation. 


Format = Fullword integer. 
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Remarks The status codes returned are as follows: 


Status 
Code Meaning 
0 NDF table storage facility entry successfully updated. 
2 Table facility error. An error message is issued and the data is 


not stored. Do not call the routine again. 


3 in_data_key not matched with an existing entry. No error 
message is issued and the table is not updated. 


11 Incorrect input. An error message is issued and the table is 
not updated. 


Example 
CALL ICNUSTUP('USERKEY%', 'MORE DATA FOR TABLE ',OUT CODE) 


This call changes the data stored under the key 'USERKEY' from 'TWENTY BYTES OF 
DATA' to 'MORE DATA FOR TABLE' and sets out_code to 0. 
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Glossary 


This glossary includes terms and definitions from: 


e The American National Standard Dictionary for 
Information Systems, ANSI X3.172-1990, copyright 
1990 by the American National Standards Institute 
(ANSI). Copies may be purchased from the Amer- 
ican National Standards Institute, 11 West 42nd 
Street, New York, New York 10036. Definitions are 
identified by the symbol (A) after the definition. 


e The ANSI/EIA Standard—440-A, Fiber Optic Termi- 
nology. Copies may be purchased from the Elec- 
tronic Industries Association, 2001 Pennsylvania 
Avenue, N.W., Washington, DC 20006. Definitions 
are identified by the symbol (E) after the definition. 


e The Information Technology Vocabulary, developed 
by Subcommittee 1, Joint Technical Committee 1, of 
the International Organization for Standardization 
and the International Electrotechnical Commission 
(ISO/IEC JTC1/SC1). Definitions of published parts 
of this vocabulary are identified by the symbol (I) 
after the definition; definitions taken from draft inter- 
national standards, committee drafts, and working 
papers being developed by ISO/IEC JTC1/SCi are 
identified by the symbol (T) after the definition, indi- 
cating that final agreement has not yet been 
reached among the participating National Bodies of 
SC1. 


e The Network Working Group Request for Com- 
ments: 1208. 


The following cross-references are used in this glos- 
Sary: 

Contrast with: This refers to a term that has an 
opposed or substantively different meaning. 


Synonym for: This indicates that the term has the 
same meaning as a preferred term, which is defined in 
its proper place in the glossary. 


Synonymous with: This is a backward reference from 
a defined term to all other terms that have the same 
meaning. 


See: This refers the reader to multiple-word terms that 
have the same last word. 


See also: This refers the reader to terms that have a 
related, but not synonymous, meaning. 


Deprecated term for: This indicates that the term 
should not be used. It refers to a preferred term, which 
is defined in its proper place in the glossary. 
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A 


abend. (1) Abnormal end of task. (2) Synonym for 
abnormal termination. 


abnormal end. Synonym for abnormal termination. 


abnormal end of task (abend). Termination of a task 
before its completion because of an error condition that 
cannot be resolved by recovery facilities while the task 
is executing. 


abnormal termination. (1) The cessation of proc- 
essing prior to planned termination. (T) (2) A system 
failure or operator action that causes a job to end 
unsuccessfully. (3) Synonymous with abend and 
abnormal end. 


ACB. In NCP, adapter control block. 
ACF. Advanced Communications Function. 


ACF/TAP. Advanced Communications Function/Trace 
Analysis Program. Synonymous with TAP. 


ACF/TCAM. Advanced Communications Function for 
the Telecommunications Access Method. Synonym for 
TCAM. 


ACF/VTAM. Advanced Communications Function for 
the Virtual Telecommunications Access Method. 
Synonym for VIAM. 


ACTLINK. Activate link. 


ACTPU. Activate physical unit. In SNA, a command 
used to start a session on a physical unit. 


adapter control block (ACB). In NCP, a contro! block 
that contains line control information and the states of 
/O operations for BSC lines, SS lines, or SDLC links. 


address. |n data communication, the unique code 
assigned to each device or workstation connected to a 
network. 


addressing. In data communication, the way in which 
a station selects the station to which it is to send data. 


Advanced Communications Function (ACF). A 
group of IBM licensed programs, principally VTAM, 
TCAM, NCP, and SSP, that use the concepts of 
Systems Network Architecture (SNA), including distrib- 
ution of function and resource sharing. 
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Advanced Communications Function/Trace Analysis 
Program (ACF/TAP). An SSP program service aid 
that assists in analyzing trace data produced by VT AM, 
TCAM, and NCP and provides network data traffic and 
network error reports. Synonymous with Trace Analysis 
Program (TAP). 


alias address. An address used by a gateway NCP 
and a gateway system services control point (SSCP) in 
one network to represent a logical unit (LU) or SSCP in 
another network. 


AND operation. Synonym for conjunction. 


basic transmission unit (BTU). In SNA, the unit of 
data and control information passed between path 
control components. A BTU can consist of one or more 
path information units (PIUs). See also blocking of 
PIUs. 


begin bracket. In SNA, the value (binary 1) of the 
begin-bracket indicator in the request header (RH) of 
the first request in the first chain of a bracket; the value 
denotes the start of a bracket. Contrast with end 
bracket. See also bracket. 


BER. (1) Box event record. (2) Box error record. 


binary synchronous communication (BSC). A form 
of telecommunication line control that uses a standard 
set of transmission control characters and control char- 
acter sequences, for binary synchronous transmission 
of binary-coded data between stations. Contrast with 
Synchronous Data Link Control (SDLC). 


binary synchronous transmission. Data trans- 
mission in which synchronization of characters is con- 
trolled by timing signals generated at the sending and 
receiving stations. See also start-stop transmission and 
Synchronous Data Link Control (SDLC). 


BIND. In SNA, a request to activate a session between 
two logical units (_LUs). See also session activation 
request. Contrast with UNBIND. 


blocking of PIUs. In SNA, an optional function of path 
control that combines multiple path information units 
(PIUs) in a single basic transmission unit (BTU). 


Note: When blocking is not done, a BTU consists of 
one PIU. 


boundary function. (1) In SNA, a capability of a 
subarea node to provide protocol support for attached 
peripheral nodes, such as: (a) interconnecting subarea 
path control and peripheral path control elements, (b) 
performing session sequence numbering for low- 
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function peripheral nodes, and (c) providing session- 
level pacing support. (2) In SNA, the component that 
provides these capabilities. 


bracket. In SNA, one or more chains of request units 
and their responses that are exchanged between two 
session partners and that represent a transaction 
between them. A bracket must be completed before 
another bracket can be started. Examples of brackets 
are database inquiries/replies, update transactions, and 
remote job entry output sequences to workstations. 


bracket protocol. In SNA, a data flow control protocol 
in which exchanges between two session partners are 
achieved through the use of brackets, with one partner 
designated at session activation as the first speaker and 
the other as the bidder. The bracket protocol involves 
bracket initiation and termination rules. 


BSC. Binary synchronous communication. 
BTU. Basic transmission unit. 


bus. (1) A facility for transferring data between several 
devices located between two end points, only one 
device being able to transmit at a given moment. (T) 
(2) A computer configuration in which processors are 
interconnected in series. 


C 


CA. Channel adapter. 
CCU. Central control unit. 


channel. (1) A path along which signals can be sent, 
for example, data channel, output channel. (A) (2) A 
functional unit, controlled by the processor, that handles 
the transfer of data between processor storage and 
local peripheral equipment. See input/output channel. 


channel adapter. A communication controller hard- 
ware unit that is used to attach the communication con- 
troller to a host channel. 


channel-attached. (1) Pertaining to the attachment of 
devices directly by input/output channels to a host 
processor. (2) Pertaining to devices attached to a con- 
trolling unit by cables, rather than by telecommunication 
lines. Contrast with link-attached. Synonymous with 
local. 


circuit. (1) One or more conductors through which an 
electric current can flow. See physical circuit and virtual 
circuit. (2) A logic device. 


circuit switching. (1) A process that, on demand, 


connects two or more data terminal equipment (DTEs) 
and permits the exclusive use of a data circuit between 
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them until the connection is released. (|) (A) (2) Synon- 
ymous with line switching. (3) See also message 
Switching and packet switching. 


communication controller. A type of communication 
control unit whose operations are controlled by one or 
more programs stored and executed in the unit. It 
manages the details of line control and the routing of 
data through a network. 


communication scanner processor (CSP). A 
processor in the 3725 Communication Controller that 
contains a microprocessor with control code. The code 
controls transmission of data over links attached to the 
CSP. 


configuration report program (CRP). An SSP utility 
program that creates a configuration report listing 
network resources and resource attributes for networks 
with NCP, EP, PEP, or VTAM. 


contention. In a session, a situation in which both 
NAUs attempt to initiate the same action at the same 
time, such as when both attempt to send data in a half- 
duplex protocol (half-duplex contention), or both attempt 
to start a bracket (bracket contention). At session initi- 
ation, one NAU is defined to be the contention winner; 
its action will take precedence when contention occurs. 
The contention loser must get explicit or implicit permis- 
sion from the contention winner to begin its action. 


control block. (1) A storage area used by a computer 
program to hold control information. (I) (2) In the IBM 
Token-Ring Network, a specifically formatted block of 
information provided from the application program to the 
Adapter Support Interface to request an operation. 


control point (CP). (1) A component of an APPN or 
LEN node that manages the resources of that node. In 
an APPN node, the CP is capable of engaging in 
CP-CP sessions with other APPN nodes. In an APPN 
network node, the CP also provides services to adja- 
cent end nodes in the APPN network. (2) A component 
of a node that manages resources of that node and 
optionally provides services to other nodes in the 
network. Examples are a system services control point 
(SSCP) in a type 5 subarea node, a network node 
control point (NNCP) in an APPN network node, and an 
end node control point (ENCP) in an APPN or LEN end 
node. An SSCP and an NNCP can provide services to 
other nodes. 


control program. (1) A computer program designed 
to schedule and to supervise the execution of programs 
of a computer system. (I) (A) (2) The part of the AIX 
Base Operating System that determines the order in 
which basic functions should be performed. (3) See 
VM/370 control program (CP). 
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control statement. In the NetView program, a state- 
ment in a command list that controls the processing 
sequence of the command list or allows the command 
list to send messages to the operator and receive input 
from the operator. 


CP. (1) VM/370 control program. (2) Control point. 
CRP. Configuration report program. 

CSP. Communication scanner processor. 

CT. Control terminal. 


CWALL. An NCP threshold of buffer availability, below 
which the NCP will accept only high-priority path infor- 
mation units (PIUs). 


D 


DAF. Destination address field. 
DAF’. Destination address field prime. 
data channel. Synonym for input/output channel. 


data flow control (DFC). In SNA, a request/response 
unit (RU) category used for requests and responses 
exchanged between the data flow control layer in one 
half-session and the data flow control layer in the 
session partner. 


data flow control (DFC) layer. In SNA, the layer 
within a half-session that controls whether the half- 
session can send, receive, or concurrently send and 
receive, request units (RUs); groups related RUs into 
RU chains; delimits transactions via the bracket pro- 
tocol; controls the interlocking of requests and 
responses in accordance with control modes specified 
at session activation; generates sequence numbers; 
and correlates requests and responses. 


data flow control (DFC) protocol. In SNA, the 
sequencing rules for requests and responses by which 
network addressable units (NAUs) in a session coordi- 
nate and control data transfer and other operations; for 
example, bracket protocol. 


data link. In SNA, synonym for /ink. 


data link control (DLC). A set of rules used by nodes 
on a data link (such as an SDLC link or a token ring) to 
accomplish an orderly exchange of information. 


data link control (DLC) layer. In SNA, the layer that 
consists of the link stations that schedule data transfer 
over a link between two nodes and perform error control 
for the link. Examples of data link control are SDLC for 
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serial-by-bit link connection and data link control for the 
Systenv370 channel. 


Note: The DLC layer is usually independent of the 
physical transport mechanism and ensures the integrity 
of data that reaches the higher layers. 


data link level. (1) In the hierarchical structure of a 
data station, the conceptual level of control or proc- 
essing logic between high level logic and the data link 
that maintains control of the data link. The data link 
level performs such functions as inserting transmit bits 
and deleting receive bits; interpreting address and 
control fields: generating, transmitting, and interpreting 
commands and responses; and computing and inter- 
preting frame check sequences. See also higher level, 
packet level, and physical level. (2) In X.25 communi- 
cations, synonym for frame level. 


definite response (DR). In SNA, a protocol requested 
in the form-of-response-requested field of the request 
header that directs the receiver of the request to return 
a response unconditionally, whether positive or nega- 
tive, to that request chain. Contrast with exception 
response and no response. 


definition statement. |n NCP, a type of instruction 
that defines a resource to the NCP. See Figure 1. 
See also macroinstruction. 


definition keyword operand 


statement 
identifier suboperands 
LINE AUTO= (YES , 32) 


definition statement 


Figure 1. Example of an NCP Definition Statement 


destination address. A code that identifies the 
location to which information is to be sent. 


destination address field (DAF). In SNA, a field ina 
FIDO or FID1 transmission header that contains the 
network address of the destination. 


destination subarea field (DSAF). In SNA, a field ina 
FID4 transmission header that contains a subarea 
address, which combined with the element address in 
the destination element field, gives the complete 
network address of the destination network addressable 
unit (NAU). Contrast with origin subarea field. 


DFC. Data flow control. 


disabled. (1) Pertaining to a state of a processing unit 
that prevents the occurrence of certain types of inter- 
ruptions. (2) Pertaining to the state in which a trans- 
mission control unit or audio response unit cannot 
accept incoming calls on a line. See also enabled. 
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DLC. Data link control. 


domain operator. In a multiple-domain network, the 
person or program that controls operation of resources 
controlled by one system services control point (SSCP). 
See also network operator. 


DSAF. Destination subarea field. 
DSECT. Dummy control section. 


duplex. Pertaining to communication in which data can 
be sent and received at the same time. Synonymous 
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dynamic reconfiguration (DR). The process of 
changing the network configuration (peripheral PUs and 
LUs) without regenerating complete configuration tables 
or deactivating the affected major node. 


E 


ECB. Event control block. 


echo. (1) In computer graphics, the immediate notifi- 
cation of the current values provided by an input device 
to the operator at the display console. (I) (A) (2) In 
word processing, to print or display each character or 
line as it is keyed in. (3) In data communication, a 
reflected signal on a communications channel. Ona 
communications terminal, each signal is displayed 
twice, once when entered at the local terminal and 
again when returned over the communications link. 
This allows the signals to be checked for accuracy. 


element. (1) A field in the network address. (2) In 
SNA, the particular resource within a subarea that is 
identified by an element address. See also subarea. 


element address. In SNA, a value in the element 
address field of the network address identifying a spe- 
cific resource within a subarea. See subarea address. 


Emulation Program (EP). An IBM control program 
that allows a channel-attached 3705 or 3725 communi- 
cation controller to emulate the functions of an IBM 
2701 Data Adapter Unit, an IBM 2702 Transmission 
Control, or an IBM 2703 Transmission Control. See 
also network contro! program. 


enabled. (1) Pertaining to a state of the processing 
unit that allows the occurrence of certain types of inter- 
ruptions. (2) Pertaining to the state in which a trans- 
mission control unit or an audio response unit can 
accept incoming calls on a line. See also disabled. 


end bracket. In SNA, the value (binary 1) of the end 
bracket indicator in the request header (RH) of the first 
request of the last chain of a bracket; the value denotes 
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the end of the bracket. Contrast with begin bracket. 
See also bracket. 


entry point (EP). In SNA, a type 2.0, type 2.1, type 4, 
or type 5 node that provides distributed network man- 
agement support. It sends network management data 
about itself and the resources it controls to a focal point 
for centralized processing, and it receives and executes 
focal-point initiated commands to manage and control 
its resources. 


EP. Emulation Program. 
ER. (1) Explicit route. (2) Exception response. 
ERP. Error recovery procedures. 


error recovery procedures (ERP). (1) Procedures 
designed to help isolate and, where possible, to recover 
from errors in equipment. The procedures are often 
used in conjunction with programs that record informa- 
tion on machine malfunctions. (2) A set of routines that 
attempt to recover from transmission errors. 


ESC. Execution sequence control. 


event control block (ECB). A control block used to 
represent the status of an event. 


exception request (EXR). In SNA, a request that 
replaces another message unit in which an error has 
been detected and that carries sense data identifying 
the error. 


exception response (ER). !In SNA, a protocol 
requested in the form-of-response-requested field of a 
request header that directs the receiver to return a 
response only if the request is unacceptable as 
received or cannot be processed; that is, a negative 
response, but not a positive response, can be returned. 
Contrast with definite response and no response. 


exchange identification (XID). A specific type of 
basic link unit that is used to convey node and link 
characteristics between adjacent nodes. XIDs are 
exchanged between link stations before and during link 
activation to establish and negotiate link and node char- 
acteristics, and after link activation to communicate 
changes in these characteristics. 


explicit route (ER). In SNA, a series of one or more 
transmission groups that connect two subarea nodes. 
An explicit route is identified by an origin subarea 
address, a destination subarea address, an explicit 
route number, and a reverse explicit route number. 
Contrast with virtual route (VR). 


EXR. Exception request. 
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extended architecture (XA). An extension to 
Systen/370 architecture that takes advantage of contin- 
uing high performance enhancements to computer 
system hardware. 


extended network addressing. The network 
addressing system that splits the address into an 8-bit 
subarea and a 15-bit element portion. The subarea 
portion of the address is used to address host 
processors or communication controllers. The element 
portion is used to permit processors or controllers to 
address resources. 


FDX. Full duplex. 
FID. Format identification. 
FIFO. First-in-first-out. (A) 


flow control. In SNA, the process of managing the 
rate at which data traffic passes between components 
of the network. The purpose of flow control is to opti- 
mize the rate of flow of message units with minimum 
congestion in the network; that is, to neither overflow 
the buffers at the receiver or at intermediate routing 
nodes, nor leave the receiver waiting for more message 
units. See also adaptive session-level pacing, pacing, 
and session-level pacing. 


FMD. Function management data. 


format identification (FID) field. In SNA, a field in 
each transmission header (TH) that indicates the format 
of the TH; that is, the presence or absence of certain 
fields. TH formats differ in accordance with the types of 
nodes between which they pass. Following are the six 
FID types: 


FIDO, used for traffic involving non-SNA devices 
between adjacent subarea nodes when either or 
both nodes do not support explicit route and virtual 
route protocols 


FID1, used for traffic involving SNA devices 
between adjacent subarea nodes when either or 
both nodes do not support explicit route and virtual 
route protocols 


FID2, used for traffic between a subarea node and 
an adjacent type 2 peripheral node 


FID3, used for traffic between a subarea node and 
an adjacent type 1 peripheral node 


FID4, used for traffic between adjacent subarea 
nodes when both nodes support explicit route and 
virtual route protocols 


FIDF, used for certain commands (for example, for 
transmission group control) sent between adjacent 
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subarea nodes when both nodes support explicit 
route and virtual route protocols. 


frame. (1) In Open Systems Interconnection architec- 
ture, a data structure pertaining to a particular area of 
knowledge and consisting of slots that can accept the 
values of specific attributes and from which inferences 
can be drawn by appropriate procedural 

attachments. (T) (2) The unit of transmission in some 
local area networks, including the IBM Token-Ring 
Network. It includes delimiters, control characters, infor- 
mation, and checking characters. (3) In SDLC, the 
vehicle for every command, every response, and all 


~~ rent ym 


information that is transmitted using SDLC procedures. 
frame level. See /ink level. 


full duplex (FDX). Synonym for duplex. 


G 


gateway. (1) A functional unit that interconnects two 
computer networks with different network architectures. 
A gateway connects networks or systems of different 
architectures. A bridge interconnects networks or 
systems with the same or similar architectures. (T) 

(2) In the AIX operating system, an entity that operates 
above the link layer and translates, when required, the 
interface and protocol used by one network into those 
used by another distinct network. (3) In TCP/IP, a 
device used to connect two systems that use either the 
same or different communications protocols. (4) The 
combination of machines and programs that provide 
address translation, name translation, and system ser- 
vices control point (SSCP) rerouting between inde- 
pendent SNA networks to.allow those networks to 
communicate. A gateway consists of one gateway NCP 
and at least one gateway VTAM. (5) In the IBM Token- 
Ring Network, a device and its associated software that 
connect a local area network to another local area 
network or a host that uses different logical link proto- 
cols. 


gateway NCP. An NCP that performs address trans- 
lation to allow cross-network session traffic. The 
gateway NCP connects two or more independent SNA 
networks. Synonymous with gateway node. 


gateway node. Synonym for gateway NCP. 


generation definition. The definition statement of a 
resource used in generating a program. 


generic alert. A product-independent method of 
encoding alert data by means of both (a) code points 
indexing short units of stored text and (b) textual data. 


generic unbind. Synonym for session deactivation 
request. 
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half-duplex (HD, HDX). In data communication, per- 
taining to transmission in only one direction at a time. 
Contrast with duplex. See also half-duplex operation 
and half-duplex transmission. 


host processor. (1) A processor that controls all or 
part of a user application network. (T) (2) In a network, 
the processing unit in which the data communication 
access method resides. 


i 
I frame. Information frame. 
VO. Input/output. 


ICW. Interface control word. 


INITIATE. A network services request sent from a 
logical unit (LU) to a system services control point 
(SSCP) requesting that an LU-LU session be estab- 
lished. 


input/output channel. (1) In a data processing 
system, a functional unit that handles transfer of data 
between internal and peripheral equipment. (I) (A) 

(2) In a computing system, a functional unit, controlled 
by a processor, that handles transfer of data between 
processor storage and local peripheral devices. Synon- 
ymous with data channel. See channel. See also link. 


interface. (1) A shared boundary between two func- 
tional units, defined by functional characteristics, signal 
characteristics, or other characteristics, as appropriate. 
The concept includes the specification of the connection 
of two devices having different functions. (T) (2) Hard- 
ware, software, or both, that links systems, programs, or 
devices. 


J 


JCL. Job control language. 


job control language (JCL). A control language used 
to identify a job to an operating system and to describe 
the job's requirements. 


K 


keyword. (1) In programming languages, a lexical unit 
that, in certain contexts, characterizes some language 
construct; for example, in some contexts, IF character- 
izes an if-statement. A keyword normally has the form 
of an identifier. (1) (2) One of the predefined words of 
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an artificial language. (A) (3) A significant and inform- 
ative word in a title or document that describes the 
content of that document. (4) A name or symbol that 
identifies a parameter. (5) The part of a command 
operand that consists of a specific character string 
(such as DSNAME=). See also definition statement and 
keyword operand. Contrast with positional operand. 


keyword operand. An operand that consists of a 
keyword followed by one or more values (such as 
DSNAME=HELLO). See also definition statement. Contrast 
with positional operand. 


keyword parameter. A parameter that consists of a 
keyword followed by one or more values. 


L 


LCB. Local block common. 
LEN. Low-entry networking. 


LIC. (1) Last-in-chain. (2) In NCP, line interface 
coupler. 


line. (1) The portion of a data circuit external to data 
circuit-terminating equipment (DCE), that connects the 
DCE to a data switching exchange (DSE), that connects 
a DCE to one or more other DCEs, or that connects a 
DSE to another DSE. (I) (2) Synonymous with channe/ 
and circuit. 


line group. One or more telecommunication lines of 
the same type that can be activated and deactivated as 
a unit. 


line switching. Synonym for circuit switching. 


link. (1) The combination of the link connection (the 
transmission medium) and two link stations, one at each 
end of the link connection. A link connection can be 
shared among multiple links in a multipoint or token-ring 
configuration. (2) To interconnect items of data or 
portions of one or more computer programs: for 
example, the linking of object programs by a linkage 
editor, linking of data items by pointers. (T) 


link-attached. Pertaining to devices that are con- 
nected to a controlling unit by a data link. Contrast with 
channel-attached. Synonymous with remote. 


link level. A part of Recommendation X.25 that 
defines the link protocol used to get data into and out of 
the network across the full-duplex link connecting the 
subscriber's machine to the network node. LAP and 
LAPB are the link access protocols recommended by 
the CCITT. See data link level. 
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Link Problem Determination Aid (LPDA). A series of 
procedures that are used to test the status of and to 
control DCEs, the communication line, and the remote 
device interface. These procedures, or a subset of 
them, are implemented by host programs (such as the 
NetView program and VTAM), communication controller 
programs (such as NCP), and IBM LPDA DCEs. See 
also LPDA-1 and LPDA-2. 


local. Pertaining to a device accessed directly without 
use of a telecommunication line. Synonym for channel- 
attached. 


logical unit (LU). A type of network accessible unit 
that enables end users to gain access to network 
resources and communicate with each other. 


logical unit (LU) 6.2. A type of logical unit that sup- 
ports general communication between programs in a 
distributed processing environment. LU 6.2 is charac- 
terized by (a) a peer relationship between session part- 
ners, (b) efficient utilization of a session for multiple 
transactions, (c) comprehensive end-to-end error proc- 
essing, and (d) a generic application program interface 
(API) consisting of structured verbs that are mapped 
into a product implementation. 


low-entry networking (LEN). A capability of nodes to 
attach directly to one another using basic peer-to-peer 
protocols to support multiple and parallel sessions 
between logical units. 


low-entry networking (LEN) end node. A LEN node 
receiving network services from an adjacent APPN 
network node. 


low-entry networking (LEN) node. A node that pro- 
vides a range of end-user services, attaches directly to 
other nodes using peer protocols, and derives network 
services implicitly from an adjacent APPN network 
node, that is, without the direct use of CP-CP sessions. 


LPDA. Link Problem Determination Aid. 


LPDA-1. The first version of the LPDA command set. 
LPDA-1 is not compatible with LPDA-2. See also Link 
Problem Determination Aid (LPDA) and LPDA-2. 


LPDA-2. The second version of the LPDA command 
set. LPDA-2 provides all of the functions of LPDA-1; it 
also supports commands such as the following: 


¢ DCE configuration 
e Dial 
e Set transmit speed 


e Commands to operate a contact that can control 
external devices. 
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See also Link Problem Determination Aid (LPDA) and 
LPDA-1. 


LU. Logical unit. 


LU-LU session. A logical connection between two 
logical units (LUs) in an SNA network that typically pro- 
vides communication between two end users. 


macroinstruction. (1) An instruction in a source lan- 
guage that is to be renlaced by a defined seauence of 
instructions in the same source language and that may 
also specify values for parameters in the replaced 
instructions. (T) (2) In assembler programming, an 
assembler language statement that causes the assem- 
bler to process a predefined set of statements called a 
macro definition. The statements normally produced 
from the macro definition replace the macroinstruction in 
the program. See also definition statement. 


maintenance and operator subsystem (MOSS). A 
subsystem of an IBM communication controller, such as 
the 3725 or the 3720, that contains a processor and 
operates independently of the rest of the controller. It 
loads and supervises the controller, runs problem deter- 
mination procedures, and assists in maintaining both 
hardware and software. 


mixed-media multilink transmission group 
(MMMLTG). See transmission group (TG). 


MLTG. Multilink transmission group. 

MMMLTG. Mixed-media multilink transmission group. 
MOSS. Maintenance and operator subsystem. 

MSG. Console messages. 


multilink transmission group (MLTG). See trans- 
mission group (TG). 


Multiple Virtual Storage (MVS). See MVS. 


MVS. Multiple Virtual Storage. Implies MVS/370, the 
MVS/XA product, and the MVS/ESA product. 


MVS/ESA product. Multiple Virtual Storage/Enterprise 
Systems Architecture. 


MVS/XA product. Multiple Virtual Storage/Extended 
Architecture product, consisting of MVS/System Product 
Version 2 and the MVS/XA Data Facility Product, oper- 
ating on a Systen/370 processor in the System/370 
extended architecture mode. MVS/XA allows virtual 
storage addressing to 2 gigabytes. See also MVS. 
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native network. The subnetwork whose network iden- 
tifier a node uses for its own network-qualified resource 
names. 


NCP. Network Control Program. 


NCP/EP definition facility (NDF). A program that is 
part of System Support Programs (SSP) and that is 
used to generate a load module for a partitioned emu- 
lation program (PEP), a Network Control Program 
(NCP), or an Emulation Program (EP). 


NDF. NCP/EP definition facility. 


NetView Performance Monitor (NPM). An IBM 
licensed program that collects, monitors, analyzes, and 
displays data relevant to the performance of a VITAM 
telecommunication network. It runs as an online VTAM 
application program. 


network address. (1) In a subarea network, an 
address, consisting of subarea and element fields, that 
identifies a link, link station, physical unit, logical unit, or 
system services control point. Subarea nodes use 
network addresses; peripheral nodes use local 
addresses or local-form session identifiers (LFSIDs). 
The boundary function in the subarea node to which a 
peripheral node is attached transforms local addresses 
or LFSIDs to network addresses and vice versa. Con- 
trast with network name. (2) According to ISO 7498-3, 
a name, unambiguous within the OSI environment, that 
identifies a set of network service access points. 


network control (NC). In SNA, a request/response 
unit (RU) category used for requests and responses 
exchanged between physical units (PUs) for such pur- 
poses as activating and deactivating explicit and virtual 
routes and sending load modules to adjust peripheral 
nodes. See also data flow control, function manage- 
ment data, and session control. 


network control program. A program, generated by 
the user from a library of IBM-supplied modules, that 
controls the operation of a communication controller. 


Network Control Program (NCP). An IBM licensed 
program that provides communication controller support 
for single-domain, multiple-domain, and interconnected 
network capability. 


network management vector transport (NMVT). A 
management services request/response unit (RU) that 
flows over an active session between physical unit man- 
agement services and control point management ser- 
vices (SSCP-PU session). 
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network name. (1) The symbolic identifier by which 
end users refer to a network accessible unit, a link, or a 
link station within a given subnetwork. In APPN net- 
works, network names are also used for routing pur- 
poses. Contrast with network address. (2) Ina 
multiple-domain network, the name of the APPL state- 
ment defining a VTAM application program. The 
network name must be unique across domains. Con- 
trast with ACB name. See uninterpreted name. 


network performance analyzer (NPA). A function of 
NCP that collects performance data about devices. The 
data is recorded by NPM. 


Network Routing Facility (NRF). An IBM licensed 
program that resides in NCP. NRF provides a path for 
routing messages between terminals and routes mes- 
sages over this path without going through the host 
processor. 


Network Terminal Option (NTO). An IBM licensed 
program, used in conjunction with NCP, that allows 
certain non-SNA devices to participate in sessions with 
SNA application programs in the host processor. When 
data is sent from a non-SNA device to the host 
processor, NTO converts non-SNA protocol to SNA pro- 
tocol; and when data is sent from the host processor to 
the non-SNA device, NTO converts SNA protocol to 
non-SNA protocol. 


NMVT. Network management vector transport. 


no response. In SNA, a protocol requested in the 
form-of-response-requested field of the request header 
that directs the receiver of the request not to return any 
response, regardless of whether or not the request is 
received and processed successfully. Contrast with 
definite response and exception response. 


node. (1) In a network, a point at which one or more 
functional units connect channels or data circuits. (I) 
(2) Any device, attached to a network, that transmits 
and receives data. (3) An endpoint of a link or a junc- 
tion common to two or more links in a network. Nodes 
can be processors, communication controllers, cluster 
controllers, or terminals. Nodes can vary in routing and 
other functional capabilities. 


NOTIFY. A network services request that is sent by a 
system services control point (SSCP) to a logical unit 
(LU) to inform the LU of the status of a procedure 
requested by the LU. 

NPA. Network performance analyzer. 


NPM. NetView Performance Monitor. 


NPSI. X.25 NCP Packet Switching Interface. 
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NRF. Network Routing Facility. 


NTO. Network Terminal Option. 


OAF. Origin address field. 


OAF'. Origin address field prime. 


operand. (1) An entity on which an operation is per- 
formed. (I) (2) That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (A) (3) Information entered with a command 
name to define the data on which a command 
processor operates and to control the execution of the 
command processor. (4) An expression to whose value 
an operator is applied. See also definition statement, 
keyword, keyword parameter, and parameter. 


Operating System/Virtual Storage (OS/VS). A family 
of operating systems that control IBM Syster/360 and 

Systen/370 computing systems. OS/VS includes VS1, 
VS2, MVS/370, and MVS/XA. 


origin address field (OAF). In SNA, a field in a FIDO 
or FID1 transmission header that contains the address 
of the originating network accessible unit (NAU). Con- 
trast with destination address field. See also format 
identification (FID) field and local session identification 
(LSID). 


Origin subarea field (OSAF). In SNA, a subarea field 
in a FID4 transmission header that contains a subarea 
address, which combined with the element address in 
the origin element field, gives the complete network 
address of the originating network accessible unit 
(NAU). Contrast with destination subarea field. 


OS/VS. Operating System/Virtual Storage. 


OSAF. Origin subarea field. 


p 


pacing. A technique by which a receiving component 
controls the rate of transmission of a sending compo- 
nent to prevent overrun or congestion. See session- 
level pacing, send pacing, and virtual route (VR) pacing. 
See also flow control. 


pacing group. Synonym for pacing window. 


pacing response. In SNA, an indicator that signifies 
the readiness of a receiving component to accept 
another pacing group. The indicator is carried in a 
response header (RH) for session-level pacing and in a 
transmission header (TH) for virtual route pacing. 
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pacing window. (1) The path information units (PIUs) 
that can be transmitted on a virtual route before a 
virtual-route pacing response is received, indicating that 
the virtual route receiver is ready to receive more PlUs 
on the route. (2) The requests that can be transmitted 
on the normal flow in one direction on a session before 
a session-level pacing response is received, indicating 
that the receiver is ready to accept the next group of 
requests. (3) Synonymous with pacing group. 


packet. In data communication, a sequence of binary 
digits, including data and control signals, that is trans- 
mitted and switched as a composite whole. The data, 
control signals, and, possibly, error control information 
are arranged in a specific format. (I) 


packet level. (1) The packet format and control proce- 
dures for exchange of packets containing control infor- 
mation and user data between data terminal equipment 
(DTE) and data circuit-terminating equipment (DCE). 
See also data link level, higher level, and physical level. 
(2) A part of Recommendation X.25 that defines the 
protocol for establishing logical connections between 
two DTEs and for transferring data on these con- 
nections. 


packet mode operation. Synonym for packet 
switching. 


packet switching. (1) The process of routing and 
transferring data by means of addressed packets so 
that a channel is occupied only during transmission of a 
packet. On completion of the transmission, the channel 
is made available for transfer of other packets. (1) 

(2) Synonymous with packet mode operation. See also 
circuit switching. 


PAD. Packet assembler/disassembler. 


parameter. (1) A variable that is given a constant 
value for a specified application and that may denote 
the application. (1) (A) (2) In Basic CUA architecture, a 
variable used in conjunction with a command to affect 
its result. (3) An item in a menu for which the user 
specifies a value or for which the system provides a 
value when the menu is interpreted. (4) Data passed 
to a program or procedure by a user or another 
program, namely as an operand in a language state- 
ment, as an item in a menu, or as a shared data struc- 
ture. See also keyword, keyword parameter, and 
operand. 


path. (1) In a network, any route between any two 
nodes. A path may include more than one branch. (T) 
(2) The series of transport network components (path 
control and data link control) that are traversed by the 
information exchanged between two network accessible 
units. See also explicit route (ER), route extension, and 
virtual route (VR). 
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path control (PC). The function that routes message 
units between network accessible units in the network 
and provides the paths between them. It converts the 
basic information units (BIUs) from transmission control 
(possibly segmenting them) into path information units 
(PiUs) and exchanges basic transmission units con- 
taining one or more PlUs with data link control. Path 
control differs by node type: some nodes (APPN 
nodes, for example) use locally generated session iden- 
tifiers for routing, and others (subarea nodes) use 
network addresses for routing. 


path information unit (PIU). A message unit con- 
sisting of a transmission header (TH) alone, or a TH fol- 
lowed by a basic information unit (BIU) or a BIU 
segment. See also transmission header. 


PCID. Procedure-correlation identifier. 
PDF. Parallel data field. 


peripheral logical unit (LU). In SNA, a logical unit in 
a peripheral node. 


peripheral node. A node that uses local addresses for 
routing and therefore is not affected by changes in 
network addresses. A peripheral node requires 
boundary-function assistance from an adjacent subarea 
node. A peripheral node can be a type 1, 2.0, or 2.1 
node connected to a subarea boundary node. 


peripheral path control. The function in a peripheral 
node that routes message units between units with local 
addresses and provides the paths between them. See 
path control and subarea path control. See also 
boundary function, peripheral node, and subarea node. 


peripheral PU. In SNA, a physical unit (PU) in a 
peripheral node. 


physical level. In X.25, the mechanical, electrical, 
functional, and procedural media used to activate, main- 
tain, and deactivate the physical link between the data 
terminal equipment (DTE) and the data circuit- 
terminating equipment (DCE). See data link level and 
packet level. 


physical unit (PU). The component that manages and 
monitors the resources (such as attached links and 
adjacent link stations) associated with a node, as 
requested by an SSCP via an SSCP-PU session. An 
SSCP activates a session with the physical unit in order 
to indirectly manage, through the PU, resources of the 
node such as attached links. This term applies to type 
2.0, type 4, and type 5 nodes only. See also peripheral 
PU and subarea PU. 


physical unit (PU) services. In SNA, the components 
within a physical unit (PU) that provide configuration 
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services and maintenance services for SSCP-PU ses- 
sions. See also /ogical unit (LU) services. 


PIU. Path information unit. 
PLU. Primary logical unit. 


positional operand. An operand in a language state- 
ment that has a fixed position. See also definition 
statement. Contrast with keyword operand. 


procedure-correlation identifier (PCID). In SNA, a 
value used to correlate all requests and replies associ- 
ated with a given procedure. 


protection key. An indicator that appears in the 
current program status word whenever an associated 
task has control of the system. This indicator must 
match the storage keys of all main storage blocks that 
the task is to use. 


PU. Physical unit. 


R 


RAS. Reliability, availability, and serviceability. 


real address. The address by which a logical unit (LU) 
is known within the SNA network in which it resides. 


RECMS. Record maintenance statistics. 


record maintenance statistics (RECMS). An SNA 
error event record built from an NCP or line error and 
sent unsolicited to the host. 


reentrant. The attribute of a program or routine that 
allows the same copy of the program or routine to be 
used concurrently by two or more tasks. 


REGS. Registers. 


remote. Pertaining to a system, program, or device 
that is accessed through a telecommunication line. 
Contrast with focal, Synonym for link-attached. 


request header (RH). The control information that pre- 
cedes a request unit (RU). See also request/response 
header (RH). 


request unit (RU). A message unit that contains 
control information, end-user data, or both. 


request/response header (RH). Control information 
associated with a particular RU. The RH precedes the 
request/response unit (RU) and specifies the type of RU 
(request unit or response unit). 
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request/response unit (RU). A generic term for a 
request unit or a response unit. See request unit (RU) 
and response unit (RU). 


response header (RH). A header, optionally followed 
by a response unit (RU), that indicates whether the 
response is positive or negative and that may contain a 
pacing response. See also negative response, pacing 
response, and positive response. 


response unit (RU). A message unit that acknowl- 
edges a request unit. It may contain prefix information 
received in a request unit. If positive, the response unit 
may contain additional information (such as session 
parameters in response to BIND SESSION). If nega- 
tive, the response unit contains sense data defining the 
exception condition. 


REX. Route extension. 
RH. Request/response header. 


route. (1) An ordered sequence of nodes and trans- 
mission groups (TGs) that represent a path from an 
Origin node to a destination node traversed by the traffic 
exchanged between them. (2) The path that network 
traffic uses to get from source to destination. 


route daemon. A program that runs under 4BSD 
UNIX to propagate route information among machines 
on a local area network. Also referred to as routed 
(pronounced “route-d”). 


route extension (REX). In SNA, the path control 
network components, including a peripheral link, that 
make up the portion of a path between a subarea node 
and a network addressable unit (NAU) in an adjacent 
peripheral node. See also explicit route (ER), path, and 
virtual route (VR). 


routed. Pronounced “route-d.” See route daemon. 


router. (1) A computer that determines the path of 
network traffic flow. The path selection is made from 
several paths based on information obtained from spe- 
cific protocols, algorithms that attempt to identify the 
shortest or best path, and other criteria such as metrics 
or protocol-specific destination addresses. (2) An 
attaching device that connects two LAN segments, 
which use similar or different architectures, at the refer- 
ence model network layer. Contrast with bridge and 
gateway. (3) In OSI terminology, a function that deter- 
mines a path by which an entity can be reached. 


RR. Receive ready. 


RU. Request/response unit. 
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S 


SC. Session control. 


scanner. (1) A device that examines a spatial pattern 
one part after another, and generates analog or digital 
signals corresponding to the pattern. Scanners are 
often used in mark sensing, pattern recognition, or char- 
acter recognition. (I) (A) (2) For the 3725 communi- 
cation controller, a processor dedicated to controlling a 
small number of telecommunication lines. It provides 
the connection between the line interface coupler hard- 
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scanner interface trace (SIT). A record of the activity 
within the communication scanner processor (CSP) for 
a specified data link between an IBM 3725 Communi- 
cation Controller and a resource. 


SCB. (1) Session control block. (2) String control 
byte. 


SCF. Secondary control field. 
SDB. Storage descriptor block. 
SDLC. Synchronous Data Link Control. 


sequence number. In communications, a number 
assigned to a particular frame or packet to control the 
transmission flow and receipt of data. 


session. (1) In network architecture, for the purpose 
of data communication between functional units, all the 
activities which take place during the establishment, 
maintenance, and release of the connection. (T) (2) A 
logical connection between two network accessible units 
(NAUs) that can be activated, tailored to provide various 
protocols, and deactivated, as requested. Each session 
is uniquely identified in a transmission header (TH) 
accompanying any transmissions exchanged during the 
session. 


session activation request. In SNA, a request that 
activates a session between two network accessible 
units (NAUs) and specifies session parameters that 
control various protocols during session activity; for 
example, BIND and ACTPU. Contrast with session 
deactivation request. 


session control (SC). In SNA, either of the following: 


¢ One of the components of transmission control. 
Session control is used to purge data flowing in a 
session after an unrecoverable error occurs, to 
resynchronize the data flow after such an error, and 
to perform cryptographic verification. 


e A request unit (RU) category used for requests and 
responses exchanged between the session control 
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components of a session and for session activation 
and deactivation requests and responses. 


session control block (SCB). In NPM, control blocks 
in common storage area for session collection. 


session deactivation request. In SNA, a request that 
deactivates a session between two network accessible 
units (NAUs); for example, UNBIND and DACTPU. 
Synonymous with generic unbind. Contrast with 
session activation request. 


session-level pacing. A flow control technique that 
permits a receiving haif-session or session connector to 
control the data transfer rate (the rate at which it 
receives request units) on the normal flow. It is used to 
prevent overloading a receiver with unprocessed 
requests when the sender can generate requests faster 
than the receiver can process them. See pacing and 
virtual route pacing. 


session partner. In SNA, one of the two network 
accessible units (NAUs) having an active session. 


SIT. Scanner interface trace. 
SLU. Secondary logical unit. 
SNA. Systems Network Architecture. 


SNA network. The part of a user-application network 
that conforms to the formats and protocols of Systems 
Network Architecture. It enables reliable transfer of 
data among end users and provides protocols for con- 
trolling the resources of various network configurations. 
The SNA network consists of network accessible units 
(NAUs), boundary function, gateway function, and inter- 
mediate session routing function components; and the 
transport network. 


SNA network interconnection (SNI)._ The connection, 
by gateways, of two or more independent SNA net- 
works to allow communication between logical units in 
those networks. The individual SNA networks retain 
their independence. 


SNI. SNA network interconnection. 

SS. (1) Start-stop. (2) Session services. 
SSCP. System services control point. 
SSP. System Support Programs. 


start-stop (SS) transmission. (1) Asynchronous 
transmission such that each group of signals repres- 
enting a character is preceded by a start signal and is 
followed by a stop signal. (T) (A) (2) Asynchronous 
transmission in which a group of bits is (a) preceded by 
a start bit that prepares the receiving mechanism for the 
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reception and registration of a character, and (b) fol- 
lowed by at least one stop bit that enables the receiving 
mechanism to come to an idle condition pending recep- 
tion of the next character. See also binary synchronous 
transmission and synchronous data link control. 


subarea. A portion of the SNA network consisting of a 
subarea node, attached peripheral nodes, and associ- 
ated resources. Within a subarea node, all network 
accessible units (NAUs), links, and adjacent link 
stations (in attached peripheral or subarea nodes) that 
are addressable within the subarea share a common 
subarea address and have distinct element addresses. 


subarea address. A value in the subarea field of the 
network address that identifies a particular subarea. 
See also element address. 


subarea node (SN). A node that uses network 
addresses for routing and maintains routing tables that 
reflect the configuration of the network. Subarea nodes 
can provide gateway function to connect multiple 
subarea networks, intermediate routing function, and 
boundary function support for peripheral nodes. Type 4 
and type 5 nodes can be subarea nodes. 


subarea path control. The function in a subarea node 
that routes message units between network accessible 
units (NAUs) and provides the paths between them. 
See path control and peripheral path control. See also 
boundary function, peripheral node, and subarea node. 


subarea PU. In SNA, a physical unit (PU) in a subarea 
node. 


suboperand. One of multiple elements in a list com- 
prising an operand. See also definition statement. 


subvector. A subcomponent of the NMVT major 
vector. 


supervisor call (SVC). A request that serves as the 
interface into operating system functions, such as allo- 
cating storage. The SVC protects the operating system 
from inappropriate user entry. All operating system 
requests must be handled by SVCs. 


supervisor call instruction. An instruction that inter- 
rupts a program being executed and passes control to 
the supervisor so that it can perform a specific service 
indicated by the instruction. 


SVC. (1) Supervisor call. (2) Switched virtual circuit. 
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switched line. A telecommunication line in which the 
connection is established by dialing. Contrast with non- 
switched line. 


switched virtual circuit (SVC). An X.25 circuit that is 
dynamically established when needed. The X.25 equiv- 
alent of a switched line. 


synchronous. (1) Pertaining to two or more proc- 
esses that depend upon the occurrence of specific 
events such as common timing signals. (T) (2) Occur- 
ring with a regular or predictable time relationship. 


Synchronous Data Link Control (SDLC). A discipline 
conforming to subsets of the Advanced Data Communi- 
cation Control Procedures (ADCCP) of the American 
National Standards Institute (ANSI) and High-level Data 
Link Control (HDLC) of the International Organization 
for Standardization, for managing synchronous, code- 
transparent, serial-by-bit information transfer over a link 
connection. Transmission exchanges may be duplex or 
half-duplex over switched or nonswitched links. The 
configuration of the link connection may be point-to- 
point, multipoint, or loop. (I) Contrast with binary syn- 
chronous communication (BSC). 


system services control point (SSCP). A component 
within a subarea network for managing the configura- 
tion, coordinating network operator and problem deter- 
mination requests, and providing directory services and 
other session services for end users of the network. 
Multiple SSCPs, cooperating as peers with one another, 
can divide the network into domains of control, with 
each SSCP having a hierarchical control relationship to 
the physical units and logical units within its own 
domain. 


system slowdown. A network control program mode 
of reduced operation invoked when buffer availability 
drops below a threshold level. The network control 
program limits the amount of new data that the system 
accepts while continuing normal output activity. 


System Support Programs (SSP). An IBM licensed 
program, made up of a collection of utilities and small 
programs, that supports the operation of the NCP. 


Systems Network Architecture (SNA). The 
description of the logical structure, formats, protocols, 
and operational sequences for transmitting information 
units through, and controlling the configuration and 
operation of, networks. The layered structure of SNA 
allows the ultimate origins and destinations of informa- 
tion, that is, the end users, to be independent of and 
unaffected by the specific SNA network services and 
facilities used for information exchange. 
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TAP. Synonym for ACF/TAP. 


TCAM. Telecommunications Access Method. Synony- 
mous with ACF/TCAM. 


Telecommunications Access Method (TCAM). An 
access method used to transfer data between main 
storage and remote or local terminals. 


TG. Transmission group. 
TH. Transmission header. 


trace. (1) A record of the execution of a computer 
program. It exhibits the sequences in which the 
instructions were executed. (A) (2) For data links, a 
record of the frames and bytes transmitted or received. 


Trace Analysis Program (TAP). Synonym for 
Advanced Communications Function for the Trace Anal- 
ysis Program (ACF/TAP). 


transmission group (TG). (1) A connection between 
adjacent nodes that is identified by a transmission 
group number. See also parallel transmission groups. 
(2) In a subarea network, a single link or a group of 
links between adjacent nodes. When a transmission 
group consists of a group of links, the links are viewed 
as a single logical link, and the transmission group is 
called a multilink transmission group (MLTG). A mixed- 
media multilink transmission group (MMMLTG) is one 
that contains links of different medium types (for 
example, token-ring, switched SDLC, nonswitched 
SDLC, and frame-relay links). (3) In an APPN network, 
a single link between adjacent nodes. 


transmission group (TG) vector. A representation of 
an endpoint TG in a T2.1 network, consisting of two 
control vectors: the TG Descriptor (X'46') control 
vector and the TG Characteristics (X'47') control 
vector. 


transmission header (TH). Control information, 
optionally followed by a basic information unit (BIU) or a 
BIU segment, that is created and used by path control 
to route message units and to control their flow within 
the network. See also path information unit. 


transmission priority. A rank assigned to a message 
unit that determines its precedence for being selected 
by the path control component in each node along a 
route for forwarding to the next node in the route. 
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U 


UNBIND. In SNA, a request to deactivate a session 
between two logical units (LUs). See also session 
deactivation request. Contrast with B/ND. 


UP. Unnumbered poll. 


user-written generation application. A user-written 
program that runs with the NCP/EP definition facility 
(NDF) during NCP generation. It processes definition 
statements and operands. 


V 


virtual machine (VM). In VM, a functional equivalent 
of a computing system. On the 370 Feature of VM, a 
virtual machine operates in System/370 mode. On the 
ESA Feature of VM, a virtual machine operates in 
SystenV/370, 370-XA, ESA/370, or ESA/390 mode. 
Each virtual machine is controlled by an operating 
system. VM controls the concurrent execution of mul- 
tiple virtual machines on an actual processor complex. 


Virtual Machine/Enterprise Systems Architecture 
(VM/ESA). An IBM licensed program that manages the 
resources of a single computer so that multiple com- 
puting systems appear to exist. Each virtual machine is 
the functional equivalent of a real machine. 


Virtual Machine/Extended Architecture (VM/XA). An 
operating system that facilitates conversion to MVS/XA 
by allowing several operating systems (a production 
system and one or more test systems) to run simultane- 
ously on a single 370-XA processor. The VM/XA 
Migration Aid has three components: the control 
program (CP), the conversational monitor system 
(CMS), and the dump viewing facility. 


virtual route (VR). In SNA, either a) a logical con- 
nection between two subarea nodes that is physically 
realized as a particular explicit route or b) a logical con- 
nection that is contained wholly within a subarea node 
for intranode sessions. A virtual route between distinct 
subarea nodes imposes a transmission priority on the 
underlying explicit route, provides flow control through 
virtual route pacing, and provides data integrity through 
sequence numbering of path information units (PIUs). 
See also explicit route (ER), path, and route extension 
(REX). 


virtual route (VR) pacing. In SNA, a flow control tech- 
nique used by the virtual route control component of 
path control at each end of a virtual route to control the 
rate at which path information units (PIUs) flow over the 
virtual route. VR pacing can be adjusted according to 
traffic congestion in any of the nodes along the route. 
See also pacing and session-level pacing. 
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virtual route identifier (VRID). In SNA, a virtual route 
number and a transmission priority number that, when 
combined with the subarea addresses for the subareas 
at each end of a route, identify the virtual route. 


Virtual Storage Extended (VSE). An IBM licensed 
program whose full name is the Virtual Storage 
Extended/Advanced Function. It is a software operating 
system controlling the execution of programs. 


Virtual Telecommunications Access Method 
(VTAM). An IBM licensed program that controls com- 
munication and the flow of data in an SNA network. It 
provides single-domain, multiple-domain, and intercon- 
nected network capability. 


VM. Virtual machine. 


VM/ESA. Virtual Machine/Enterprise Systems Architec- 
ture. 


VM/SP. Virtual Machine/System Product. 

VM/XA. Virtual Machine/Extended Architecture. 
VM/370. IBM Virtual Machine Facility/370. 

VM/370 control program (CP). The component of 
VM/370 that manages the resources of a single com- 
puter with the result that multiple computing systems 
appear to exist. Each virtual machine is the functional 
equivalent of an IBM System/370 computing system. 
VR. Virtual route. 


VRID. Virtual route identifier. 
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VS. Virtual storage. 


VSE. Virtual Storage Extended. Synonymous with 
VSE/Advanced Functions. 


VSE/Advanced Functions. The basic operating 
system support needed for a VSE-controlled installation. 
Synonym for VSE. 


VSE/ESA. Virtual Storage Extended/Enterprise 
Systems Architecture. 


VSE/SP. Virtual Storage Extended/System Package. 


VTAM. Virtual Telecommunications Access Method. 
Synonymous with ACF/VTAM. 


X 


X.25. An International Telegraph and Telephone 
Consultative Committee (CCITT) recommendation for 
the interface between data terminal equipment and 
packet-switched data networks. See also packet 
switching. 


X.25 NCP Packet Switching Interface (NPSI). An 
IBM licensed program that allows SNA users to commu- 
nicate over packet switching data networks that have 
interfaces complying with CCITT Recommendation 
X.25. It allows SNA programs to communicate with 
SNA or non-SNA equipment over such networks. 


XA. Extended architecture. 
XID. Exchange identification. 


XMIT. Transmit. 
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NCP, SSP, and EP Library 


The following paragraphs briefly describe the library for 
NCP, SSP, and EP. The other publications dealing with 
the networking systems products—NTune, VTAM, 
NPSI, the NetView program, and NPM—are listed 
without the accompanying descriptions. 


NCP V7R2, SSP V4R2, and EP R12 Library Directory 
(SC31-6259) 


This book helps users locate information on a variety of 
NCP, SSP, and EP tasks. It also provides a high-level 
understanding of NCP, SSP, and EP and summarizes 
the changes to these products and to the library for 
NCP V7R2, SSP V4R2, and EP R12. 


NCP V7R2 Migration Guide (SC31-6258) 


This book helps users migrate an NCP generation defi- 
nition from an earlier release to NCP V7R2. It also 
describes how to add new functions for NCP V7R2. 


NCP, SSP, and EP Resource Definition Guide 
(SC31-6223) 


This book helps users understand how to define NCP 
and EP (in the PEP environment) using SSP. It 
describes functions and resources and lists the defi- 
nition statements and keywords that define those func- 
tions and resources. 


NCP, SSP, and EP Resource Definition Reference 
(SC31-6224) 


This book helps users code definition statements and 
keywords to define NCP and EP (in the PEP environ- 
ment) using SSP. It also provides a quick reference of 
definition statement coding order and keyword syntax. 


NCP, SSP, and EP Generation and Loading Guide 
(SC31-6221) 


This book provides detailed explanations of how to gen- 
erate and load NCP and EP (in the PEP environment) 
using SSP. It contains information for generating and 
loading under MVS, VM, and VSE. 


NCP and SSP Customization Guide (LY 43-0031) 
This book helps users who are familiar with the internal 
logic of NCP and SSP to modify these products. It 


describes how to change NCP and SSP to support 
stations that IBM-supplied programs do not support. 
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NCP and SSP Customization Reference (LY 43-0032) 


This book supplements the NCP and SSP 
Customization Guide. \t describes the resources and 
macroinstructions provided by IBM for customizing NCP 
and SSP. 


NCP, SSP, and EP Messages and Codes (SC31-6222) 


This book is a reference book of abend codes issued by 
NCP and EP in the PEP environment, and messages 
issued by the System Support Programs associated 
with NCP. This information is also available through the 
online message facility, an IBM OS/2 application avail- 
able on diskette. 


NCP, SSP, and EP Trace Analysis Handbook 
(LY 43-0037) 


This book describes how to use the trace analysis 
program and how to read trace analysis program 
output. 


NCP, SSP, and EP Diagnosis Guide (LY 43-0033) 


This book helps users isolate and define problems in 
NCP and EP (in the PEP environment) using SSP. The 
primary purpose of the book is to help the user interact 
with the IBM Support Center to resolve a problem. In 
addition, it explains some of the diagnostic aids and 
service aids available with SSP. 


NCP, SSP, and EP Diagnosis Aid (LK2T-1999, 
diskettes) 


The Diagnosis Aid is an IBM OS/2 application used to 
diagnose NCP, SSP, and EP problems. This tool helps 
programmers and program support personnel who are 
responsible for isolating, diagnosing, and debugging 
problems in NCP and EP (in the PEP environment) 
using SSP. The Diagnosis Aid, available on diskette, 
provides online access to all the information contained 
in the NCP, SSP, and EP Diagnosis Guide, the NCP 
and EP Reference Summary and Data Areas, the NCP, 
SSP, and EP Messages and Codes, and the NCP, 
SSP, and EP Trace Analysis Handbook. 


NCP and EP Reference (LY43-0029) 


" This book describes various aspects of the internal 


processing of NCP and EP in the PEP environment. It 
provides information for customization and diagnosis. 


NCP and EP Reference Summary and Data Areas 
(LY43-0030) 
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This two-volume book provides quick access to 
often-used diagnostic and debugging information about 
NCP and EP in the PEP environment. 


Other Networking Systems 
Products Libraries 


The following publications provide cross-product infor- 
mation for NTune, VTAM, NPSI, NetView, and NPM. 
For detailed information about these products, refer to 
the library for each. 


Networking Systems Library 

The following list shows the publications in the Net- 
working Systems library (this library currently contains 
information about NCP at the V7R1 level). 

Planning for NetView, NCP, and VTAM (SC31-7122) 
Planning for Integrated Networks (SC31-7123) 


Planning Aids: Pre-Installation Planning Checklist for 
NetView, NCP, and VTAM (SX75-0092) 


IBM Networking Systems Softcopy Collection Kit 
(CD-ROM, SK2T-6012) 


IBM Online Libraries: Softcopy Collection Kit User's 
Guide (GC28-1700) 


NTune Library 


The following list shows the publications in the NTune 
library. 


NTune User's Guide (SC31-6247) 


NTuneNCP Reference (LY43-0035) 


VTAM Library 


The following list shows the publications in the VTAM 
V4R2 library. 


VTAM Migration Guide (GC31-6491) 

VTAM Release Guide (GC31-6492) 

Estimating Storage for VTAM (SK2T-2007) 

VTAM Network Implementation Guide (SC31-6494) 
VTAM Resource Definition Reference (SC31-6498) 


VTAM Resource Definition Samples (SC31-6499, book 
and diskettes) 
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VTAM Customization (LY 43-0063) 

VTAM Operation (SC31-6495) 

VTAM Operation Quick Reference (SX75-0205) 
Using IBM CommandTree/2 (SC31-7013) 

VTAM Messages and Codes (SC31-6493) 

VTAM Licensed Program Specifications (GC31-6490) 
VTAM Programming (SC31-6496) 

VTAM Programming Quick Reference (SX75-0206) 
VTAM Programming for LU 6.2 (SC31-6497) 
VTAM Diagnosis (LY 43-0065) 

VTAM Diagnosis Quick Reference (LX75-0204) 


VTAM Data Areas for MVS (LY43-0064) 


NPSI Library 


The following list shows the publications in the NPSI 
Version 3 library. 


X.25 NCP Packet Switching Interface General Informa- 
tion (GC30-3469) 


X.25 NCP Packet Switching Interface Planning and 
Installation (SC30-3470) 


X.25 NCP Packet Switching Interface Host Program- 
ming (SC30-3502) 


X.25 NCP Packet Switching Interface Diagnosis, 
Customization, and Tuning (LY30-5610) 


X.25 NCP Packet Switching Interface Data Areas 
(LY 43-0034) 


X.25 NCP Packet Switching Interface Master Index 
(GC31-6206) 


NetView Library 


The following list shows the publications in the NetView 
V2R4 library. 


NetView General Information (GC31-7098) 
Learning about NetView (SK2T-6017, diskettes) 


Learning about NetView Graphic Monitor Facility 
(SK2T-6018, diskettes) 
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NetView Graphic Monitor Facility Reference Poster 
(SX75-0100) 


NetView Automation Planning (SC31-7083) 


NetView Storage Estimates (SK2T-6016, diskette for a 
PS/2 or a PS/55) 


NetView Installation and Administration Guide 
(SC31-7084 for MVS) 


NetView Installation and Administration Facility/2 Guide 
(or NIAF/2 Guide, SC31-7099) 


NetView Administration Reference (SC31-7080) 
NetView Bridge Implementation (SC31-6131) 
NetView Tuning Guide (SC31-7079) 

NetView Automation Implementation (LY 43-0016) 
NetView Customization Guide (SC31-7091) 


NetView Customization: Writing Command Lists 
(SC31-7092) 


NetView Customization: Using PL/I and C (SC31-7093) 
NetView Customization: Using Assembler (SC31-7094) 
NetView Operation (SC31-7086) 


NetView Graphic Monitor Facility User's Guide 
(SC31-7089) 


NetView Command Quick Reference (SX75-0090) 
NetView Messages (SC31-7096) 

NetView Resource Alerts Reference (SC31-7097) 
NetView Application Programming Guide (SC31-7081) 


NetView Resource Object Data Manager Programming 
Guide (SC31-7095) 


NetView Problem Determination and Diagnosis 
(LY 43-0101) 


NPM Library 


The following list shows the publications in the NPM V2 
library. 


NetView Performance Monitor at a Glance (GH19-6960) 


NetView Performance Monitor Concepts and Planning 
(GH19-6961) 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


Bibliography 


NetView Performance Monitor User's Guide 
(SH19-6962) 


NetView Performance Monitor Messages and Codes 
(SH19-6966) 


NetView Performance Monitor Graphic Subsystem 
(SH19-6967) 


NetView Performance Monitor Installation and 
Customization (SH19-6964) 


NetView Performance Monitor Reports and Record 
Formats (SH19-6965) 


NetView Performance Monitor Diagnosis (LY 19-6381) 


NetView Performance Monitor Desk/2 User's Guide 
(SH19-6963) 


Related Publications 


The following publications, though not directly related to 
NCP, may be helpful in understanding your network. 


3704/3705 Communication Controllers Assembler Lan- 
guage (GC30-3003) 


IBM 3745 Communication 
Controller Publications 


The following list shows selected publications for the 
IBM 3745 Communication Controller. 


IBM 3745 Communication Controller Introduction 
(GA33-0092 for the 3745-210, 3745-310, 3745-410, and 
3745-610) 


IBM 3745 Communication Controller Introduction 
(GA33-0138 for the 3745-130, 3745-150, and 3745-1 70) 


IBM 3745 Communication Controller Configuration 
Program (GA33-0093) 


IBM 3745 Communication Controller (All Models): Prin- 
ciples of Operation (SA33-0102) 


Bibliography 549 


Bibliography 


SNA Publications 


The following publications contain information on SNA. 


Systems Network Architecture Technical Overview 
(GC30-3073) 


Systems Network Architecture Format and Protocol Ref- 
erence Manual: Management Services (SC30-3346) 
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Systems Network Architecture Formats (GA27-3136) 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


“Restricted Materials of IBM” 
Licensed Materials — Property of IBM 


index 


A 
AAB (achain anchor block) 31, 41 
abend codes 20 
ABEND macro 20 
ABORT macro 21 
ABORTVR macro 23 
absolute notation, definition of 17 
achain anchor block (AAB) 31, 41 
achain element block (AEB) 31, 36, 42 
ACHAIN macro 24 
ACHAINs 36, 41 
activating statement groups 514 
actual length, determining 484 
ACTVR response 23 
ACTVRIT macro 
description 27 
warning 27 
adapter control block (ACB) 99 
adding 
comment to generated statement group 516 
entry to table storage facility 523 
keyword to generation definition 506 
ADVAN macro 29 
AEB (achain element block) 31, 36, 42, 99 
AFIND macro 31 
ALLOCATE macro 33 
anchor block 24 
ANDIF macro 35 
ASCAN macro 36 
ASHIFT macro 38 
ATTACHVR macro 39 
AUNCHAIN macro 41 


BAL macro 44 
basic transmission unit (BTU) 
BCUSRES field 51, 375 
releasing buffer chain for 22 
system response byte 21 
BCU (block control unit (BSC/SS)) 
building 275 
copying 106 
dequeueing or unchaining 118, 157 
disposing 375 
getting a data byte from 166 
queueing 150, 185 
returning an address 266 
stopping execution of BH 21 
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BDT (block dump table) 

defining first entry 175 

indicating end of line group 174 
BFREVENT macro 45 
BH (buffer prefix), buffer tag field 368 
BHEXIT macro 47 


index 


binary synchronous communication (BSC) macros 10 


binary tree macros 9 
bits 
checking for empty trees 58 
converting to decimal strings 497 
converting to numeric values 496 
deleting nodes 56 
inserting nodes 60 
searching 63 
BLDR macro 51 
BLKENTRY macro 52 
block control unit (BSC/SS) (BCU) 
building 275 
copying 106 
dequeueing or unchaining 118, 157 
disposing 375 
getting a data byte from 166 
queueing 150, 185 
returning an address 266 
stopping execution of BH 21 
block control unit work area 106 
block dump table (BDT) 
defining first entry 175 
indicating end of line group 174 
block handler macros 9 
Boolean flags, tracing 475 
boundary buffer pool (BPOOL) 28, 33, 34 
boundary session accounting, status 237 
boundary session block (BSB) 123 
BPOOL (boundary buffer pool) 28, 33, 34 
Branch macro instructions 55 
branch-on-bit format 
used for DOWHILE and DOUNTIL 133 
used for IF 179 
branch-on-count format (DOWHILE and 
DOUNTIL) 139 
BSB (boundary session block) 123 


BSC (binary synchronous communication) macros 10 


BIDELETE macro 56 

BTECHECK macro 58 

BTINSERT macro 60 

BTSEARCH macro 63 

BTU (basic transmission unit) 
BCUSRES field 51, 375 
releasing buffer chain for 22 
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BTU (basic transmission unit) (continued) 
system response byte 21 

BUFCHK macro 66 

buffer management macros 10 

buffer pool 94 

BUILDPIU macro 67 


C 


CAB (channel adapter control block) 206 
CAIO macro 74 
CALL macro 76 
CASE macro 79 
CASEIF macro 79 
CASENTRY macro 79 
CASEXIT macro 79 
CBB (committed buffers block) 100, 115 
CCB (character control block) 
CCBLATO field 351 
used with TVSIDL 387 
used with TVSNEW 390 
CHAIN macro 86 
chains 
buffer chain 
allocating 193 
CHAIN macro 86 
chained relationship 52 
copying datato andfrom 215 
decommitting a buffer 116 
detaching a buffer 400 
finding last buffer 345 
getting next buffer 345 
releasing 22, 284 
RCB chain 282 
save areachains 112, 288 
scanning NCP buffer chains 345 
channel adapter control block (CAB) 206 
channel macro 10 
CHAP macro 92 
character control block (CCB) 
CCBLATO field 351 
used with TVSIDL 387 
used with TVSNEW 390 
CHECKSSI macro 94 
CHECKVR macro 96 
COMMIT macro 99 
committed buffers block (CBB) 100, 115 
common physical unit block (CUB) 
CUBRSE field 126 
CUBTYPE field 126 
COMPARE macro 102 
comparing strings 487 
comparison format 
used for DOWHILE and DOUNTIL 136 
used for |F 181 
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concatenating strings 486 
conditional branch symbol 117 
control blocks 


AAB (achain anchor block) 31, 41 
ACB (adapter control block) 99, 115 
AEB (achain element block) 31, 36, 42 
BCU (block control unit (BSC/SS) 
building 275 
copying 106 
dequeueing or unchaining 118, 157 
disposing 375 
getting a data byte from 166 
queueing 150, 185 
returning an address 266 
BH (buffer prefix), buffer tag field 368 
BSB (boundary session block) 124 
CAB (channel adapter control block) 206 
CBB (committed buffers block) 100 
CCB (character control block) 
CCBLATO field 351 
used with TVSIDL 387 
used with TVSNEW 390 
CUB (common physical unit block) 
CUBRSE field 126 
CUBTYPE field 126 
DVB (device base control block) 124 
ECB (event control block) 
building 144 
ECBSTAT field 108 
initializing the status bytes 145 
leasing 108, 193 
putting on an event queue 45 
releasing buffer 285 
FLB (multilink transmission group control block) 206 
GCB (group control block) 
transfer address control 268 
used with SDB 347 
L4B (level 4 router control block) 255. 
LKB (line control block (SDLC)) 163 
NLX (programmed resource logical unit block exten- 
sion) 
used with NCHNG 221, 223 
used with NPARMS 239 
used with UACTRIN 398 
used with UPARMS 403 
programmed resource control blocks 
changing fields in 221, 225 
getting data from 239 
PSB (physical services block) 
PSBSNPP field 328 
storing SNP address in 326 
QCB (queue control block) 
attaching to queue 150 
changing priority 92 
defining storage for 277 
dequeueing or unchaining 118 
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control blocks (continued) 
QCB (queue control block) (continued) 
detaching from queue 157 
finding address of 173 
initializing resource 161 
inserting task 162 
macro 273 
moving contents of 219 
purging a queue 273 
queueing 185 
reserving 271 
returning address 266 
task reactivating 280 
tracing 142 
used with ENQUE 150 
used with EXTRACT 157 
used with FVTABLE 161 
used with GETPARM 172 
validating 408 
XYZSTAP field 271 
RCB (resource connection block) 
chaining to the VVT 39 
changing fields 221 
detaching from a virtual route 121 
immediate bit, setting 416 
RCBBLK field 283 
scanning 282 
states 23,110 
VVT index field 39 
SCB (station control block) 
linking witha TGB 206 
naming generic alerts 164 
setting transmission group status 427 
SNP (SSCP-NCP session control block) 
SNPSSTAT field 329 
used with RSLVCAP 304 
used with RSLVSNP 326 
TGB (transmission group control block) 
checking states and conditions 371 
linking 206 
UACB (user adapter control block) 
building 347 
posting 268 
returning a pointer to 160 
specifying length 175 
VRB (virtual route control block) 96, 337 
converting 
bits to decimal strings 497 
bits to numeric values 496 
decimal strings to numbers 498 
hexadecimal strings to numbers 501 
nonstandard strings to standard strings 492 
numbers to decimal strings 488, 499 
numbers to hexadecimal strings 500 
strings to nonstandard strings 491 


LY43-0032-01 © Copyright IBM Corp. 1988, 1994 


CONVRT macro 104 
COPYBCU macro 106 
COPYPIU macro 67, 108 
CUB (common physical unit block) 
CUBRSE field 126 
CUBTYPE field 126 
CXTSVX macro 112 


D 

DACTVRIT macro 114 

date and time of generation, getting 502 
decimal numbers, tracing 478 

decimal strings, converting to numbers 498 
DECOMMIT macro 115 

default messages, printing 473 

defining subroutine entry points 363 
definition statements, saving 519 
DEFMSK macro 117 

DEQUE macro 118, 157, 273 
DETACHVR macro 121 

determining string's logical length 490 
device base control block (DVB) 124 
DEVPARMS macro 123 

dispatcher trace 142, 159 


DO-X-by-Y format (DOWHILE and DOUNTIL) 137 


DOWHILE and DOUNTIL macros 
branch-on-bit format 133 
branch-on-count format 139 
comparison format 136 
description 127 
DO-X-by-Y format 137 
logical connective evaluation 128 
no-operation format 130 
test CL, ZL format 131 
test-under-mask format 134 
used with ENDDO 148 
used with LEAVEDO 203 

DTRACE macro 142 

dump utility 52, 175 

DVB (device base control block) 124 


E 


ECB (event control block) 
building 144 
ECBSTAT field 108, 110 
initializing the status bytes 145 
leasing 108, 193 
putting on an event queue 45 
releasing buffer 285 

ECB macro 144 

ECBINIT macro 145 

element 
attaching to the end of a queue 150 


Index 


Index 
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element (continued) 
detaching from a queue 157 
setting priority 352 
element address 
getting from SNP mask 224 
getting RCB or RVT entry for 322 
getting SNP pointer for 326 
ELSE macro 
description 146 
used with ENDIF 149 
used with IF 176 
used with THEN 146 
ENDCASE macro 79 
ENDDO macro 127, 148, 203 
ENDIF macro 
description 149, 374 
used with ELSE 146 
used with IF 176 
used with THEN 149 
ENQUE macro 150, 185, 353 
equated notation, definition of 17 
event contro! block (ECB) 
building 144 
ECBSTAT field 108, 110 
initializing the status bytes 145 
leasing 108, 193 
putting on an event queue 45 
releasing buffer 285 
EXCR macro 154 
explicit route mask 104 
explicit route number 104 
EXTRACT macro 118, 157 
EXTRN statement, generating 359 


F 


fat link (multilink transmission group), setting SCB 
status 427 
FETRACE macro 159 
finding string 489 
FINDUACB macro 160 
FLB (multilink transmission group control block) 206, 
427 
flow control macros 10 
formatted strings, printing 472 
formatting value into string 488 
function, macros grouped by 9 
FVT (function vector table) 
building 161 
GCB, GCBL3 field 268 
FVTABLE macro 161 
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G 

GALERT macro 163 

gateway accounting 407 

gateway NCP 314 

GCB (group control block) 
transfer address control 268 
used with SDB 347 

GENEND definition statement 464 

generation definition 
adding keywords to 506 
replacing keywords in 508 

GETBYTE macro 166 

GETCB macro 168 

GETIME macro 170, 403 

GETPARM macro 172 

GETPT macro 173 

getting 
data from table storage facility 525 
date and time of generation 502, 503, 512 
keyword values 503 
network addresses 512 
NEWNAME value 511 
user-coded keyword value 462 

group control block (GCB) 
transfer address control 268 
used with SDB 347 

GRPEND macro 174 

GRPENTRY macro 52, 53, 175 


H 

hardcopy library, NCP, SSP, EP xv 
hexadecimal numbers, tracing 479 
hexadecimal strings, converting to numbers 501 
hypertext links xvi 


I/O operation, with XIO macro 417 
ICNCVLAB utility 452 
ICNCVRNG utility 454 
ICNCVTOK utility 457 
ICNERPST utility 460 
ICNIPGKI utility 462 
ICNIPPFX utility 478 
ICNLEPT2 utility 468 
ICNLEPTN utility 464 
ICNLEPTS utility 466 
ICNOBPU2 utility 471 
ICNOBPUN utility 470 
ICNRPFMT utility 472 
ICNRPINF utility 473 
ICNRPPBT utility 475 
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ICNRPPCH utility 476 INHIBIT macro 184 

ICNRPPCX utility 477 INSERT macro 185 

ICNRPPHX utility 479 interface control word (ICW) 188, 251 
ICNRPPNM utility 480 interrupt macros 10 

ICNRPTRC utility 482 interrupts, scheduling 350 

ICNSMAFT utility 483 IOHM macro 187 

ICNSMALN utility 484 

ICNSMBEF utility 485 K 

ICNSMCAT utility 486 

ICNSMCMP utility 487 keyword 

ICNSMEMT utility 488 adding to the generation definition 506 
ICNSMEND utility 489 replacing in the generation definition 508 
ICNSMLEN utility 490 values, getting 462, 503 

ICNSMPLS utility 491 

ICNSMSTD utility 492 L 

ICNSMSUB utility 493 

ICNSMTRM utility 495 ae ahs — control block) 255 
ee ee label notation, definition of 17 
ICNTCBTC utility 497 


labels 52, 53 
LASTUACB macro 191 
LDM macro 192 
LEASE macro 193, 217 

se LEAVEDO macro 127, 148, 203 
ICNUSDTG utility 502 
ICNUSGKI utility 503 level 4 router control block (L4B) 255 


level 5 input/output macros 10 
ICNUSKAD utility 506 . 
ICNUSKRP utility 508 LGT (line group table), LG@TLATO field 351 


ICNUSLIB utility 510 ne meena and EP 
ICNUSNEW utility 511 ardcopy library xv 


ICNUSRNA utility 512 ee xvi 
ICNUSSTA utility 514 softcopy library xvi 


ICNTCDEC utility 498 
ICNTCDTC utility 499 
ICNTCDTH utility 500 
ICNTCHEX utility 501 


we licensing agreement xi 
erat, 218 line control block (SDLC) (LKB) 163 
ICNUSSTI utility 517 

Ms line group, end ofina BDT 174 
ICNUSSTS utility 519 i tor table (LNVT) 160 
ICNUSTAD utility 523 aay ae oleae ) - 
ICNUSTRT utility 525 nee a 
ICNUSTUP utility 527 ie i 
ICW (interface control word) 188, 251 La 

cluster 464 


idle time-out, starting 387 
IF macro 
branch-on-bit format 179 
comparison format 181 


posting a statement 
in general 462, 464 
to produce a separate load module from 


al ee eae nly te load module from 
logical connective evaluation 176 oO pr a separa odule 
table 2 468 


test CL, ZL format 178 


test-under-mask format 180 statement 464 


used with ANDIF 35 links, hypertext xvi 
LINKTGB macro 206 
used with CASEIF 81 roy eee eaie 
used with COMPARE 102 " ete contro fg (SDLC)) 163 
used with DEFMSK 117 ae sal ania table) 160 
used with ELSE 146 oag moauie, proaucing 
from table 1 466 
used with ENDIF 149 ? 
used with THEN 374 | Heat table Z 468 
INCRP macro 183 ogica connective evaluation 


DOWHILE and DOUNTIL multiple-part tests 128 
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logical connective evaluation (continued) 
IF multiple-part tests 176 
logical length, determining 490 
LUB (logical unit block), LGTTYPE field 126 


macro name 18 

macros, by functional groups 9 

MAINT macro 210 

MAINTCS macro 211 

messages, printing default or inheritance 473 

miscellaneous macros 11 

MOVE macro 213 

MOVECHAR macro 215 

multilink transmission group (fat link), setting SCB 
status 427 

multilink transmission group control block (FLB) 206, 
427 

MVQUE macro 219 


N 


name, macro 18 
NCHNG macro 221 
NCP information macros 11 
NCP initialization 161 
NCP, SSP, and EP library 
hardcopy library xv 
hypertext links xvi 
softcopy library xvi 
NDF utilities, functions 449 
See also |CNxxxxx utility 
NEOAXT macro 226, 444 
NEOENQ macro 227 
NEOXPORT macro 228 
network addresses, getting 512 
network vector table (NVT) 306, 314 
NEWNAME value, getting 511 
NLX (programmed resource logical unit block extension) 
used with NCHNG 221, 223 
used with NPARMS 239 
used with UACTRTIN 398 
used with UPARMS 403 
no-operation format (DOWHILE and DOUNTIL) 130 
NPAPIU macro 230 
NPAQINFO macro 232 
NPAQSTAT macro 237 
NPARMS macro 239 
numbers 
converting to decimal strings 488, 499 
converting to hexadecimal strings 500 
values, tracing 480 
NVRID macro 248 
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NVT (network vector table) 306, 314 


O 


ORIF macro 35, 250 
OUTICW1 macro 251 


P 
PACEMAP macro 253 
pacing window, determining 253 
parsed value list, TYPSYS keyword 465 
passing control to or from an accounting exit 407 
path information units (PiUs) 
building 67 
deallocating 261 
delivering to VR routing 433 
dequeueing 118, 157, 158 
finding the end of 263 
macros 11 
passing between subarea node and path 
control 430 
queuing 150, 185 
sequence number, recording for session trace 343 
tracing 377 
transferring across links 421 
PCIL4 macro 255 
PERFORM macro 
description 259 
used with CXTSVX 112 
used with MOVECHAR 215 
used with RETURN 290 
physical services block (PSB) 
PSBSNPP field 328 
storing SNP address in 326 
PIU trace 
aborting 382 
continuing 379 
starting 377 
stopping 381 
PIUDEALL macro 261 
PIUEND macro 263 
point 3 block handler 376 
POINT macro 266 
point of execution 173 


pointers 53 
polling 99 
' posting 


error messages 460 
link-edit statements 
to a specific list or cluster 464, 466, 468 
to produce load module from table1 466 
to produce load module from table2 468 
POSTUACB macro 268 
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PRELEASE macro 270 
printing 
default or inheritance messages 473 
formatted strings 472 
problem determination macros 11 
procedure entries and exits, tracing 449, 482 
product-sensitive programming interface xi 
programmed resource control blocks 


See also NLX (programmed resource logical unit 


block extension) 

changing fields in 221, 225 

getting data from 239 
programmed resource macros 13 
programming interface, product-sensitive xi 
PSB (physical services block) 

PSBSNPP field 328 

storing SNP address in 326 
punching table 1 source 470 
punching table 2 source 471 
PURGQCB macro 273 
PUTBYTE macro 275 


Q 


QCB (queue control block) 
attaching to queue 150 
changing priority 92 
defining storage for 277 
dequeueing or unchaining 118 
detaching from queue 157 
finding address of 173 
initializing resource 161 
inserting task 162 
macro 273 
moving contents of 219 
purging a queue 273 
queueing 185 
reserving 271 
returning address 266 
task reactivating 280 
tracing 142 
used with ENQUE 150, 151 
used with EXTRACT 157 
used with FVTABLE 161 
used with GETPARM 172 
validating 408 
XYZSTAP field 271 

QCB macro 277 

QPOST macro 280, 384 

queue control block (QCB) 
attaching to queue 150 
changing priority 92 
defining storage for 277 
dequeueing or unchaining 118 
detaching from queue 157 
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queue control block (QCB) (continued) 
finding address of 173 
initializing resource 161 
inserting task 162 
macro 273 
moving contents of 219 
purging a queue 273 
queueing 185 
reserving 271 
returning address 266 
task reactivating 280 
tracing 142 
used with ENQUE 150, 151 
used with EXTRACT 157 
used with FVTABLE 161 
used with GETPARM 172 
validating 408 
XYZSTAP field 271 
queue management macros 11 
queues 
ACTVR queue 23 
CWALL event queue 45 
getting the address of an element 266 
moving 219 
purging 273 
slowdown event queue 45 


R 


RCB (resource connection block) 
chaining to the VVT 39 
changing fields 221 
detaching from a virtual route 121 
immediate bit, setting 416 
RCBBLK field 283 
scanning 282 
states 23 
VVT index field 39 
RCBSCAN macro 282 
registers 
exchanging contents 366 
saving 339, 341, 362 
shifting 361 
RELEASE macro 273, 284 
removing trailing blanks from strings 495 
replacing keyword in generation definition 508 
reserve buffers 270 
RESET macro 287 
resource connection block (RCB) 
chaining to the VVT 39 
changing fields 221 
detaching from a virtual route 121 
immediate bit, setting 416 
RCBBLK field 283 
scanning 282 
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index 
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resource connection block (RCB) (continued) 
states 23 
VVT index field 39 
RESTORE macro 
description 112, 288 
used with CASENTRY 83 
used with CXTSVX 112 
used with PERFORM 260, 290 
used with ROUTINE 301 
RETURN macro 112, 259, 290 
returning 
actual length of a string 484 
substring before target string 485 
substring following target string 483 
substring of specified length 493 
RNSVC macro 
generating standard linkage 292 
layout of linkage generated, table 8 
ROUTE macro 295 
ROUTEMAP macro 298 
ROUTINE macro 112, 290, 301 
RSLVCAP macro 304 
RSLVDYN macro 306 
RSLVNAD macro 310 
RSLVNET macro 314 
RSLVRID macro 322 
RSLVSNP macro 326 
RSLVSSCP macro 331 
RSLVTGB macro 334 
RSLVVVTI macro 337 


S 


save areachain 112 
save area management macros 11 
SAVE macro 
description 339 
used with CXTSVX 112 
used with LINK 205 
used with PERFORM 260 
SAVEAREA macro 77, 341 
SAVESQ macro 343 
saving definition statements 519 
SCAN macro 345 
scanner macros 12 
SCB (station control block) 
linking witha TGB 206 
naming generic alerts 164 
setting transmission group status 427 
SDB macro 347 
searching SYSLIB data set for member 510 
session trace 343 
SETEVNTL macro 349 
SETIME macro 350 
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SETLATO macro 351 
SETPRI macro 352 
SETRP1C macro 355 
SETTGB macro 356 
setting insertion point for statement group 517 
SETXTRN macro 359 
shift macros 12, 361 
SNP (SSCP-NCP session control block) 
SNPSSTAT field 329 
used with RSLVCAP 304 
used with RSLVSNP 326 
SNP mask, converting to SNP address 224, 326, 331 
softcopy library, NCP, SSP, and EP xvi 
standard string representation 
See string 
Start-stop macros 10 
statement groups 
activating 514 
adding acomment 516 
set insertion point 517 
statement, saving definition 519 
station control block (SCB) 
linking witha TGB 206 
naming generic alerts 164 
setting transmission group status 427 
string 
comparing 487 
concatenating 486 
converting 
hexadecimal to numbers 500 
to nonstandard strings 491 
to standard strings 492 
finding 483, 485, 489 
logical length, determining 490 
manipulation 449 
Standard strings 451 
validating 449, 457 
string representation 
See string 
STRM macro 362 
structuring macros 12 
subarea address 
getting from SNP mask 331 
getting TGB for 334 
subroutine entry points, defining 363 
subroutine macros 12 
SUBRTN macro 76, 363 
substrings, returning 
before atarget string 485 
following a target string 483 
specified length 493 
supervisor call (SVC) instruction 
description 364 
generating 
for NLX pointer 398 
for PIU pointer 398 
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supervisor call (SVC) instruction (continued) 
generating (continued) 
for virtual route 410 
for VRID list 248 
to pass control to level 5 407 
SVC codes, table of 7 
trace 159 
used with DACTVRIT 114 
used with RNSVC 292 
used with SVLINK 364 
used with SYSXIT 367 
supervisor macros 12 
SVLINK macro 364 
SWAP macro 366 
symbols, validating 452 
syntax diagrams 15 
SYSLIB data set 510 
system response phase 
setting 355 
with RNSVC 292 
SYSXIT macro 367 


T 


table 1 source, punching 470 
table 2 source, punching 471 
table storage facility 
adding entries to 523 
getting data from 525 
updating 527 
using 449 
TAGBUFF macro 368 
task control macros 12 
task scheduling 384 
test CL, ZL format 
used for DOWHILE and DOUNTIL 131 
used for IF 178 
test-under-mask format 
used for DOWHILE and DOUNTIL 134 
used for |F 180 
TESTTGB macro 357, 371 
TGB (transmission group control block) 
checking states and conditions 371 
linking 206 
THEN macro 
description 374 
used with ELSE 146 
used with ENDIF 149 
used with IF 176 
time and date stamp, getting and putting 170 
time-out 
changing type 388 
description 170 
refreshing or restarting 392 
starting line 390, 395 
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time-out (continued) 
starting RAS 391 
timer macros 12 


timer routines, generating return linkage for 394 


TPPOST macro 22, 375 
TRACEPIU macro 377 
traces 
activating 159 
dispatcher 142, 159 


PIU 377 
SVC 159 
tracing 


Boolean flags 475 
decimal numbers 478 
hexadecimal numbers 479 
nonstandard strings 477 
number values 480 
procedure entries and exits 449 
standard strings 476 
tracing 476 

trailing blanks, removing 495 

transfer vector table (XVT) 451 

transmission group 
controlling activation and deactivation 356 
macros for 12 

transmission group control block (TGB) 
checking states and conditions 371 
linking 206 

TRIGGER macro 384 

TVSIDL macro 387 

TVSMOD macro 388 

TVSNEW macro 390 

TVSRAS macro 391 

TVSREF macro 392 

TVSRTRN macro 394 

TVSTIME macro 395 

type conversion 449 


U 


UACB (user adapter control block) 
building 347 
posting 268 
returning a pointer to 160 
specifying length 175 
UACTRTN macro 398 
UNCHAIN macro 400 
UPARMS macro 403 
updating table storage facility 527 
URETURN macro 398, 407 
user accounting exit routine 398 
user adapter control block (UACB) 
building 347 
posting 268 
returning a pointer to 160 


index 


index 
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Index 


user adapter control block (UACB) (continued) 
specifying length 175 

user line control macros 13 

utilities, NDF, functions 449 
See also separate utilities, under ICNxxxxx 


validating 
strings 449, 457 
symbols 452 


value ranges 449, 454 
VALQCB macro 408 
value ranges, validating 449, 454 
virtual route (VR) 
See also virtual route vector table (VVT) 
activation 23, 410 
associating with a session 39 
deactivation 114 
description 27 
macros 13 
monitoring 414 
TPF (transmission priority field) 28, 114 
VRN (virtual route number) 28, 114 
virtual route control block (VRB) 96, 337 
virtual route identifier (VRID) 248, 253 
virtual route vector table (VVT) 
See also virtual route (VR) 
getting pointer to 337 
VVT index 
getting from SNP mask 331 
used with ATTACHVR 39, 40 
used with EXCR 155 
used with NEOENQ 227 
used with RSLVSSCP 331 
used with VRACT 410 
VRACT macro 23, 410 
VRACTCK macro 248, 412 
VRB (virtual route control block) 96, 337 
VREVENT macro 414 
VRID (virtual route identifier) 248, 253 
VRIMTASK macro 416 
VRPIU pool 33, 34 
VVT (virtual route vector table) 
See also virtual route (VR) 
getting pointer to 337 
VVT index 
getting from SNP mask 331 
used with ATTACHVR 39, 40 
used with EXCR 155 
used with NEOENQ 227 
used with RSLVSSCP 331 
used with VRACT 410 
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W 


warnings 
ACTVRIT 27 
DACTVRIT 114 
XIOFL 428 
WXTRN, generating 359 


X 


X!IO macro 
for line operations 417 
for SDLC link operations 421 


for transmission groups 425 
XIOFL macro 

description 427 

warning 428 
XPC macro 430 
XPORTVR macro 228, 433 


XVT (transfer vector table) 451 
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If you especially like or dislike anything about this book, please use one of the methods 
listed below to send your comments to IBM. Whichever method you choose, make sure you 
send your name, address, and telephone number if you would like a reply. 


Feel free to comment on specific errors or omissions, accuracy, organization, subject matter, 
or completeness of this book. However, the comments you send should pertain to only the 
information in this manual and the way in which the information is presented. To request 
additional publications, or to ask questions or make comments about the functions of iB 
products or systems, you should talk to your IBM representative or to your IBM authorized 
remarketer. 


When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute 
your comments in any way it believes appropriate without incurring any obligation to you. 


lf you are mailing a readers’ comment form (RCF) from a country other than the United 
States, you can give the RCF to the local IBM branch office or IBM representative for 
postage-paid mailing. 


e lf you prefer to send comments by mail, use the RCF at the back of this book. 
e lf you prefer to send comments by FAX, use this number: 

United States and Canada: 1-800-227-5088 
¢ If you prefer to send comments electronically, use this network ID: 


— IBM Mail Exchange: USIB2HPD at IBMMAIL 
— IBMLink*: CIBMORCF at RALVM13 
— Internet: USIB2HPD@VNET.IBM.COM 


Make sure to include the following in your note: 


e Title and publication number of this book 
e Page number or topic to which your comment applies. 
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We hope you find this publication useful, readable and technically accurate, but only you can tell us! Your 
comments and suggestions will help us improve our technical publications. Please take a few minutes to 
let us know what you think by completing this form. 


Overall, how satisfied are you with the information in this book? Satisfied Dissatisfied 
0 CO 
How satisfied are you that the information in this book is: Satisfied Dissatisfied 
Accurate o Oo 
Complete Oo Oo 
Easy to find o Oo 
Easy to understand oO Oo 
Well organized Oo oO 
Applicable to your task o c] 


Specific Comments or Problems: 


Please tell us how we can improve this book: 


Thank you for your response. When you send information to IBM, you grant IBM the right to use or 
distribute the information without incurring any obligation to you. You of course retain the right to use the 
information in any way you choose. 


Name Address 
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